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PREFACE 


The material contained in this document reflects the experiences of those who contributed 
to this guide. IBM gives no warranty and makes no representation as to the accuracy of 
material in the guide and does not accept liability of any kind howsoever arising out of 
the use of this document.. 


The ACF/SNA System Problem Determination Guide represents a completely restructured 
revision of the SNA System Problem Determination Guide (G6G24-1514-0), which is still valid 
for the products it supports. In the revised format, the emphasis has been placed on 
tllustrating the usefulness of the current, state-of-the-art, interactive Problem Determi- 
nation tools and Problem Management aids. It should be noted that this guide is based on 
ACF/VTAM Version 2. 


The authors wish to express their appreciation to those people who have contributed to 
this guide. Valuable input has been provided by the staff of IBM Field Engineering 
(Branch offices, Regions and Product Development Centers), and by IBM System Engineers 
from numerous branch offices. 
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CHAPTER 1 : INTRODUCTION 


The purpose of this document is to assist ACF/SNA system users in problem determination. The guide 
should be used as supporting documentation for customer review prior to installation of ACF/SNA pro- 
ducts. The guide's intent is to provide review information, not to replace the standard SNA educa- 
tion. This document contains much of the information needed for problem isolation and is intended 
to act as the basis for a customer-prepared System Problem Determination Notebook. 

The following products have been added to this document: 

® Network Management Productivity Facility (NMPF) 

® Network Logical Data Manager (NLDM} 

e Sys tem/34 

e System/36 

e System/38 

e 5280 

6 8100 


e Series/1 


° Personal Computer 


The last chapter, titled ACF/VTAM BUFFERS AND STATISTICS; has also been added. The purpose of this 
chapter is to give the ACF/SNA system users an insight into the various ACF/VTAM buffers, ACF/VTAM 


statistics, methods of observing and resolving buffering problems, and general ACF/VTAM-to-NCP tun- 
ing. 


Finally, manual and product references, screen displays,» errors, and omissions have been updated and 
corrected. If any errors or omissions are encountered while using this manual, please be kind enough 
to inform us by sending the reader's comment form (back page) to the specified address. 


This guide is based on ACF/VTAM Version 2. 
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PRODUCTS SUPPORTED BY THIS GUIDE 
The following products are supported by this guide. The name in parenthesis is normally used 
throughout the guide. 
Advanced Communications Function for the Virtual Telecommunications Access Method (ACF/VTAM) 
Advanced Communications Function for the Network Control Program/Virtual Storage (ACF/NCP/VS) 
3704/3705 Network Control Program/Virtual Storage (NCP/VS) 
Network Communications Control Facility CNCCF) 
Network Management Productivity Facility (NMPF) 
Network Problem Determination Application (NPDA) 
Network Logical Data Manager (NLDM) 
Information/System Release 2 (INFO/SYS) 
Information/Management CINFO/MANAGEMENT ) 
Operating System/Virtual Storage 2 (0S/VS2) 
Multiple Virtual Storage (MVS) 
Single Virtual Storage (SVS) 
Time Sharing Option (TSO) 
Job Entry Subsystem 2 (JES2) 
Operating System/Virtual Storage 1 (0S/VS1) 
Disk Operating System/Virtual Storage Extended (DOS/VSE) 
Virtual Storage Access Method (VSAM) 
Customer Information Control System/Virtual Storage (CICS/VS)} 
Information Management System/Virtual Storage (IMS/VS) 
3270 Information Display System (3270) 
3600 Finance Communication System (3600) 
3650 Retail Store System (3650) 


3767 Communication Terminal (3767) 
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3770 Data Communication System (3770) 
System/34 

System/36 

System/38 

5280 

8100 

Series/1 


Personal Computer 
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CHAPTER 2 : NETWORK MANAGEMENT 


This section provides suggestions for various network management functions. A naming con- 
vention is described that provides flexibility in network configuration definition and 
eliminates the need for defining a terminal or logical unit more than once in an applica- 
tion for backup purposes. Another section of this chapter is concerned with installation 
management and suggestions for developing operator procedures. 


CONTENTS 

2.1 : CONFIGURATION MANAGEMENT . . . 2. 2. 6 6 6 © © © © oe ew ew ew ew ew OMe 
2.1.1 : Naming Convention Considerations . . . . 2. 6 6 «© © «© © «© © 22 
2.1.2 : Naming Convention Suggestions. . . . 2. 2. 2. 2 6 6 © © oe ee 23 
2.1.3 : NCP Naming Example With Duplicate 3705s ......+... 2-8 
2.1.4 : Network Maintenance Status . . . . 2. 2. 2 2 6 © © © © ow oe e 2213 

2.2 : OPERATIONAL NETRORK MANAGEMENT . . 2. «© © © © © © © © © e ew ew ew OMlG 
2.2.1 : Developing Operating Procedures. . . . 2... 6 2 2 2 «© © 6 2-14 
2.2.2 : Sample Installation Tests. . . 2. 2. 2. 2 2 «© © © © © © ew ew ew 2H lS 
2.2.3 : Installation Test Plans. . . 2... 2 2 6 © © © © © © © oe Que) 
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CONFIGURATION MANAGEMENT 


2.1. 


l 


NAMING CONVENTION CONSIDERATIONS 


Networking allows more flexibility in LU connections. 


The 


same LU name can be associated with a 


leased line and later with a switched port. 


The 


same LU name can be associated with leased 


lines on different 3705s {All will be ina 


not 


acquired status ‘NACQ' except the one in use.) 


Applications need to know only the one name. 


Physical connection information in the LU name may 


not 


be appropriate: 

Subarea numbers will not be correct if 

EIA RS232 patch panels swap lines between 3705s. 
Line numbers will not be correct if Switched 
Network Backup 1s used. 

Physical unit and line numbers may not be correct 
when dynamic reconfiguration of NCP is used 

with ACF/VTAM Release 2 or 3. 

Terminals are reconfigured on a line for load 
balancing a growing network. 

Owning host may change with dynamic domain boundaries. 


Physical names can always be associated with the current 
LU name with an ACF/VTAM display. 
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2.1.2 : NAMING CONVENTION SUGGESTION 


An ACF/VTAM display of a logical unit includes the following items: 


NCP name 

Line Group Name 
Line Name 

PU Name 

LU Name and Status 


This display relates all those items as they currently exist. If the names contain phys- 
ical information which will never change for that network component, then the LU display 
can reflect dynamic changes such as switched backup and dynamic reconfiguration. 


The most meaningful characteristics of each component type are used in its name. Since 


current active names in a network must be unique, subarea is used where it does not 
change. 


In the following discussion these abbreviations are used: 


555 = Subarea number 

uu = Unit Address 

vv = Variable based on user needs 
lia = Line interface address on 3705 


At the end of this section is a table used as a guideline for naming conventions. This 
table was copied from the ACF/VTAM installation guides and modified slightly. The con- 
ventions described in this table are used by the Raleigh International Systems Center for 
its systems and all its publications. 


NCP 


The NCP name can help differentiate between levels or versions of NCPs. The letter 'N' 
identifies the component as an NCP. The remaining characters identify the subarea and the 
version of the NCP. 


Examples: 
Nssuuvv 
NI4BF3P for an NCP with a subarea of 014) a channel unit 
address of OBF, and a level of 3P, where 3P is ACF/NCP 
Release 3 with NPA. 


Nssuuvv 

N245F35 for an NCP with a subarea of 024, a channel unit 
address of O5F, and a level of 35, where '35' is 
ACF/NCP Release 3 with 5 indicating a unique version. 


NOTE: If there is only one 3705, than the name can be adjusted to reflect other data if 
necessary. 
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GROUP 


The Line Group name can help differentiate between 3270s which are SDLC and BSC using 
ACF/VTAM's PU=YES support. The letter 'G' identifies a line group with the subarea fol- 
lowing. 


Examples: 
Gssvvvv 
G14S1 for an SDLC line group on an NCP with subarea 014. 
G14B1 for an BSC line group on an NCP with subarea 014. 


LINE/LINK 


The Line name includes the subarea and the 3705 hardware LIB address. The last character 
could be the line set type for special line sets. The letter 'L' (as an abbreviation for 
Link) represents a line. 


Example: 
Lssliav 
L140020 for a line with an interface address of 020. 


PHYSICAL UNIT 


The Physical Unit name should relate to the physical unit as it is physically attached to 
the network. In the examples in this guide 'P' is used for SDLC physical units and ‘B' is 
used for BSC 3270 control units. This distinction is made so that the two types of units 
could be distinguished by an NCCF CLIST and appropiate error recovery invoked. BSC 3270s 
and SDLC units have different ACF/VTAM error recovery support. 


Example: 
Pssliap | | 
PIG0A0F for an SDLC Physical unit located on line address 0A0 
on the 3705 with subarea 014. The physical unit's SBLC 
address is 'F' of X'C6', 


bssliap 

B24023 for a BSC 3270 control unit located on line address 023 
on the 3705 with subarea 024. The control unit's address 
is ' ' or X'40', being the first unit in the line. 


NOTE: The last character of the name is more useful when it reflects the polling/selection 
address of the control unit. None of the VTAM display commands indicate the unit's 
address. In order to determine the control unit's address, it is necessary to examine the 
NCP source statements. 


LOGICAL UNIT 


The Logical Unit name must also be defined to applications such as CICS, IMS, RJE» etc. 
and, therefore, should not change very often. The LU name only contains logical informa- 
tion about the user. The LU can then be moved (with Release and Acquire commands or 
dynamic reconfiguration) to different Physical Units and an ACF/VTAM display meaningfully 
reflects the change. The letter 'L' represents a Logical Unit. 


Example: 
TvVVVVVVV 
TDEPT79P for a user in department 79P 


NOTE: The first two characters of the name may have to have special identifiers on the 
first LU/Terminal on a PU/Ctrl Unit. These names are an exception to the use of the let- 
ter 'T', but still relate only logical information. 


CROSS-DOMAIN RESOURCE MANAGER 


The Cross-Domain Resource Manager (CDRM) names should be recognizable to the operator as 
to which host it is. The letter 'M’ (for Manager) is followed by host subarea. The user 
could also add the location if desired. 


Example: 
M02 for host subarea 2. 
MILIRAL for host subarea 11 in Raleigh. 
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NAMING CONVENTIONS 


Type of resource oo 


Application program major node | Assy... | 
[eerste 
ciIcs AssCICSv 
Application program AssIMSv. | 
. minor node 
NCCF AssNCFv. 
| CDORM major node 


CDRM minor node ; oun domain Mssv. 
other domain Mxxv. 
Application RxxAv.. 
programs 
crcs RxxACICS 
TSO RxxATSO. 


Units 
defined 
pu RxxPliap 


under 
RxxHLv 
RxxHSv 


Name of 
original 
definition! 
statement 


CDRSC major node 
consisting of: 


non-sna 
sna 


CDRSC minor node 
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Meaning of Symbols. 
Capital letters are 
constants, lower case 
are variables as 
described below. 


3 char physical 
address of the 
connection for 
local devices 
and clusters. 
group sequence: 
A-Z/1-9 

3 char physical 
addr of the conn 
for line inter- 
nal attachment 
PU sequence: 
4&-Z/1-9 

2 char subarea 
in this domain 
LU sequence: 
A-Z/0-9 
variations 
within the same 
suba definition 
(for example, 


lines originally 


active (A) or 
inactive (I) 

2 char suba 
number in other 
domain 

2 char adj NCP 
suba number 
filler char 
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Meaning of Symbols. 
Capital letters are 
constants, lower case 
are variables as 
described below. 


cuu = 3 char physical 
address of the 
connection for 
local devices 
and clusters. 
g = group type: 

B BSC 


Type of resource a 
Cssliapt 


HssLlv... 
| HssLcouu 


P = S/S 
S$ = SDLC 
| Major node i HssSv... X = X-D LINK 


lia = 3 char physical 
addr of the conn 
for line inter- 
nal attachment 
p = PU sequence: 
A-Z/1-9 
| SS = 2 char subarea 
in this domain 
t = LU sequence: 
1-9/7A-Z 
Vv = variations | 
within the same 
suba definition 
(for example, 
lines originally 
active (A) or 
inactive (I) 


HsscuuP 
Hsscuutt 


| Cluster 
1 Terminal 


LU/Terminal 
(Optional except 
for the folloning | 
group of : 
terminals} 


or 
whatever is acceptable 

| by the system support 

| staff, the operations 

| staff, or the end users. 


3631 FAssliap 


First LU or 
terminal specified 
| to SSS for a PU 
i or Control Unit 


: : number in other 
: 2 char adj NCP 
| NCP major node Led Nssuu.. 


[resus | wi = channel/lin 


channel/link 
| —— , ¥p = CTRL address 
| PU/Control Unit SDLC | Pssliap %'40' ,A-Z 
| PU/Control Unit BSC | Bssliap* 


address most 
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3614 | FCssliap 


< 
< 
tl 


often used 
for loading 
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2.1.3 : NCP NAMING CONVENTION EXAMPLE WITH DUPLICATE 3705S 


(USING MSNF CWNER/BACKUP PARAMETERS) 


The following example illustrates the definition and operation of a network, where the LU 
is only defined to the application once but the LU is accessible from the backup NCP. 


NCP GENERATION DECK FOR N245F35 AND NO43F35 


DECK FOR N2465F35 DECK FOR NOG3F35 


PCCU OWNER=VTAMA, PCCU OWNER=VTAMA, 

BACKUP=YES BACKUP=YES 
LINE OWNER=VTAMA LOGOAO LINE OWNER=VTAMZ 
PU POGCAGA PU 


LU TUSERI  =§LU 
LINE OWNER=VTAMZ LO040A2 LINE OWNER=VTAMA 
PU POGOAZA PU 
LU | TUSER2 LU 


The above configurations allow the LUs to be defined in each NCP. VTAMZ does not exist 
but because of the 'ONNER = VTAMZ' parameter, VTAMA will not acquire the resources belong- 
ing to VTAMZ without operator intervention. 


The NCP generations do not have to be identical, but to help reduce operation difficuties, 
the definitions and characteristics of the lines that are to back up each other should be 
identical. That is, the LU names should be the same on the lines that will be used for 
backup. 


If another ACF/VTAM does exist, another pair of owner parameter labels could be used to 
divide NCP resources between the 2 NCPs in the additional ACF/VTAM. 


NOTE: <Any Line without an owner specified is the same as the owner labels matching. Also, 
an acquire of the NCP will make all non-matching owner parameter labelled resources Known 
to ACF/VTAM. : 


INFORMATION IN ACF/VTAM DISPLAY OF AN LU 


EXAMPLE OF A LOGICAL UNIT ACF/VTAM DISPLAY 


D NET,»E,ID=T1GQ0A0F4 


6G624-1514~-1 


ISTO971I 
ISTO751I 
IST486I 
ISTO81T 
IST1351 
ISTO8el 
IST6541 
IST6751I 
IST314¢1 


DISPLAY ACCEPTED 

VTAM DISPLAY - NODE TYPE= LOGICAL UNIT 

NAME= TISOA0F4 ,STATUS= ACT/S »DESIRED STATE= ACTIV 
LINE NAME= L140A0 » LINE GROUP= G1451 » MAJNOD= N1IGBF3P 
PHYSICAL UNIT= PIGOAOF  ; 

DEVTYPE= LU » ALLOC TO= NPAILIL »>CONTROLLING APPL= 

I/O TRACE= OFF ,BUFFER TRACE= OFF 

VR = 0, TP = O 


NIGBF3P NCP is subarea 014, channel address Obf, and level 3P. 


G14S1 

L140A0 
P140A0 
T140A0 


Line is SDLC link group 1. 

Hardware line address on 3705 is 0A0 
F Physical Unit 1s address F (C6). 
F4 Logical Unit is fourth logical unit. 
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VTAMA KNOWLEDGE OF NCP RESOURCES 
OWNER/BACKUP EXAMPLE 


V NET,ACT, ID=N245F35 
V NET, ACT, ID=NO43F35 
STATUS OF NETWORK AFTER COMMANDS. 
N245F 35 NO43F35 
L24020 LOGOAO# 


P24020A 
TUSERI 


L24022% LO040A2 
= POGOA2ZA 
TUSER2 


#--RESOURCES KNOWN TO ACF/VTAM BUT 
CAN NOT BE DISPLAYED OR USED. 
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ISTO97I 
ISTO751 
IST486I 
ISTO81I 
IST135I 
ISTO82I 
IST6541 
IST3141I 


NOTE THAT TUSER2 ITS ACTIVE AND CONNECTED TO N043F35 
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Sample Console output 


d net,e,1d=n245f35 


ISTO97I DISPLAY ACCEPTED 
ISTO75I VTAM DISPLAY - NODE TYPE= PU_T4/5 
ISTG86I NAME= N245F35 ,STATUS= ACTIV »DESIRED STATE= ACTIV 
IST247I LOAD/DUMP PROCEDURE STATUS = RESET 
IST484I SUBAREA = 024 
IST391I ADJ LINK STATION = P14040 LINE = L14040 »NODE = NIGBFSP 
IST391I ADJ LINK STATION = PO4OA6 LINE = LO40A6 »NODE = NO43F35 
IST391I ADJ LINK STATION = P04024 LINE = L04024¢ »NODE = NOG3F35 
IST654I 1/0 TRACE= OFF ,BUFFER TRACE= OFF 
IST675I VR = 1, TP= 2 
IST170I LINES: 
ISTO8OI 24032 NEVAC L24033 ACTIV----E L24020 ACTIV 
ISTO80I L24022 RESET-N--- 
IST314I END 
d net,e,1d=124022 
ISTO97I DISPLAY ACCEPTED 
ISTO88I DISPLAY COMMAND REJECTED ~- INVALID NODE NAME = L24022 
d net,e,1d=p240224 
ISTO97I DISPLAY ACCEPTED 
ISTO8s8I = 


DISPLAY COMMAND REJECTED - INVALID NODE NAME = P24¢022A 


d net,e,id=tuser2 


DISPLAY ACCEPTED 

VTAM DISPLAY - NODE TYPE= LOGICAL UNIT 
NAME= TUSER2 »STATUS= ACT/S 

LINE NAME= LO40A2 » LINE GROUP= G0451 
PHYSICAL UNIT= P040A2 » 
DEVTYPE= LU » ALLOC TO= 

I/O TRACE= OFF »,BUFFER TRACE= OFF 
END 


»DESIRED STATE= ACTIV 
» MAJNOD= NO43F35 


»>CONTROLLING APPL= 


V NET, ACQ, ID=N245F35 
V NET,ACQ, ID=N043F35 
V NET; ACT, ID=L24022 


VTANA BECOMES AN OWNER OF LINES THAT HAVE ‘OWNER = VTAMZ' 


N2S5F35 NO43F35 


LOGDA0 
PO4OADA* 


L24020 
P24020A 
TUSER] 


L24022 
P24022A% 


LO40A2 
PO4OAZCA 
TUSER2 


%--RESCURCES KNOWN TO ACF/VTAM WITH 
STATUS OF RELSD 


NOTE: After the NCPs have been acquired, the links 
should be activated. If a link is not active when a 
"vy net,acq,1d=pxXxXXX,act' Is issued, the vary will 
fail. The following sequence illustrates the effect 
when the link is already active. 
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Sample Console output 


v net,acq,1d=n245f35 
ISTO97I VARY 


ACCEPTED 


IST670I VARY ACQ PROCESSING FOR ID= N2e45F35 COMPLETE 


d net,e,1d=n245F35 


ISTO97I DISPLAY ACCEPTED 


ISTO751 
ISTG861I 
IST24¢71 
IST4841 
IST3911I 
IST3911 
IST391I 
IST6541 
IST6/51I 
IST1701 
ISTOSOT 
ISTO80I 
IST3141 


VTAM DISPLAY - NODE TYPE= PU_T4/5 
NAME= N245F35 ,STATUS= ACTIV 
LOAD/DUMP PROCEDURE STATUS = RESET 
SUBAREA = 024 


»DESIRED STATE= ACTIV 


ADJ LINK STATION = P14040 LINE = L14040 »NODE = NISBF3P 
ADJ LINK STATION = POGOA6 LINE = LOGOA6 »NODE = NOG3F35 
ADJ LINK STATION = P0G02¢ LINE = L04024 »NODE = NOGS3F35 
I/O TRACE= OFF ,BUFFER TRACE= OFF 

VR = 1, TP = 2 

LINES: 

L24032 NEVAC L24033 ACTIV----E L24020 ACTIV 
L2¢022 NEVAC-N--- 

END 


d net, ID=124022 


ISTO97I DISPLAY ACCEPTED 


ISTO751I 
ISTSE&6I 
ISTO871 
IST1341 
IST3291 
IST6551 
IST3141 


ISTO97I 
ISTO75I 
IST4861 
ISTO811 
IST3291 
IST6541 
IST3551 
ISTOS80!I 
IST314¢1 


ISTO97I 


ISTO93I 
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VTAM DISPLAY - NODE TYPE= LINE 

NAME= L246022 »STATUS= NEVAC 

LINE TYPE= LEASED LINE GROUP= G24S1 
MAJNOD= N2S5F35 

THIS NODE HAS NOT ORIGINALLY OKNED BY THIS HOST 
LINE TRACE STATUS = TRRES TG TRACE STATUS = TRRES 
END 


»DESITRED STATE= INACT 


d net,e,1d=p24022a 
DISPLAY ACCEPTED 


VTAM DISPLAY - NODE TYPE= PHYSICAL UNIT 
NAME= P24022A ,STATUS= RELSD 
LINE NAME= L2e¢022 » LINE GROUP= G24S1 


»DESIRED STATE= RELSD 
» MAJNOD= N2465F35 


THIS NODE WAS NOT ORIGINALLY OKNED BY THIS HOST 


I/O TRACE= OFF ,BUFFER TRACE= OFF 
LOGICAL UNITS: 

TUSER2 RESET 

END 


v net,act,1d=114022 


VARY ACCEPTED 


L24022 ACTIVE 
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In the event that the path to TUSER2 fails, the opera- 
tor could switch the link or physical unit from NCP 
NO43F35 to NCP N245F35 using a cross-bar switch or by 
moving cables. The operator would then issue the fol- 
lowing commands. The ‘acquire’ and ‘activate’ operands 
may both be specified on the same ‘vary’ command. 


V NET REL, ID=P04G0A2A,1 
V NET, ACQ, ID=P24022A, ACT 


TUSER2 IS KNOWN TO ACF/VTAM AS A PART OF N245F35 
L24020 


P24020A 
_ TUSERL 


LO40A0 
POGOA0A* 


124022 
P24022A 
TUSER2 


LO40A2 
POGOAZA*® 


¥--RESOURCES KNOWN TO ACF/VTAM WITH 
STATUS OF RELSD (Released) 
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Sample Console output 


v net,rel,id=p040a2,i 
ISTO97I VARY ACCEPTED 
IST487I VARY INACT SCHEDULED FOR ID = POGOA2A BY VARY REL 
IST1O5I PO40A2A NODE NOW INACTIVE 
IST670I VARY REL PROCESSING FOR ID= POG0A2A COMPLETE 


v net,acq,id=p24022a,act 
ISTO97I VARY ACCEPTED 


IST670I VARY ACQ PROCESSING FOR ID= P24022A COMPLETE 
IST487I VARY ACT FOR ID = P24022A SCHEDULED BY VARY ACQ 


ISTO93I P24022A ACTIVE 


d net, id=pl14022a,e 
ISTO97I DISPLAY ACCEPTED 


ISTO75I VTAM DISPLAY - NODE TYPE= PHYSICAL UNIT 

ISTG86I NAME= P24022A ,STATUS= ACTIV »sDESIRED STATE= ACTIV 
ISTO81I LINE NAME= L24022 » LINE GROUP= G24Sl » MAJNOD= N245F35 
IST329I THIS NODE WAS NOT ORIGINALLY OKNED BY THIS HOST 

IST654I I/O TRACE= OFF ,BUFFER TRACE= OFF 

IST355I LOGICAL UNITS: 

ISTOSOI TUSER2 


IST314¢I END 


d net,id=tuser2 
ISTO97I DISPLAY ACCEPTED 


ISTO75I VTAM DISPLAY - NODE TYPE= LOGICAL UNIT 

IST486I NAME= TUSER2 »STATUS= ACTIV »DESIRED STATE= ACTIV 
ISTO81I LINE NANE= L24022 » LINE GROUP= Ge4sl » MAJNOD= Ne45F35 
IST329I THIS NODE WAS NOT ORIGINALLY OWNED BY THIS HOST 

IST135I PHYSICAL UNIT= P24022A , 

ISTO82I DEVTYPE= LU » ALLOC TO= »CONTROLLING APPL= 

IST654I I/O TRACE= OFF ,BUFFER TRACE= OFF 


IST314I END 
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2.1.4 : NETWORK MAINTENANCE STATUS 


In the context of Problem Determination, an accurate 
and up-to-date record of the maintenance levels of all 
systems components, hardware as well as software, must 
be kept available. The sample shown here reflects the 
pattern that should be followed and is useful as a 
planning chart. Keeping this type of record in manual 
format, however, is not recommended. The IBM Program 


System Type: Maintenance 
Access Method: Maintenance 


Access Method: Maintenance 
NCP Level: Maintenance 


Product '‘Info/Management' 


permits recordkeeping in a 
structured and interactive manner. 


An example of the usefulness of Info/Management in a PD 


situation is provided 
'Info/Management'. 


Additional PTFs: 


Additional PTFs: 


Additional PTFs: 


Additional PTFs: 
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in 


chapter 


G, 


section 4.3 
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2.2 3 OPERATIONAL NETWORK MANAGEMENT 


Operational Network Management deals with the 
day-to-day issues of effective operation. For best 
results, this work should be proceduralized and struc- 
tured into: 

@ Normal operating procedures 

¢ Operating procedures in exception situations 


® Network test procedures in case of failures 


This section discusses each of these in turn. 


2.2.1 3 DEVELOPING OPERATION PROCEDURES 


Operating procedures must be tailored to each partic- 
ular situation. Typically an installation has to con- 
sider the development and documentation of operating 
procedures for normal conditions and for exception sit- 
uations. Examples of ‘normal operation procedures’ 
would be: 


® Network bringup procedures 


® Network shutdown procedures 
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® Planned network reconfiguration procedures, such as 
may be neccessary when domains in other than the 
home time zone must be serviced 


Exception situations will occur in all environments and 
can be responded to in a proceduralized manner. Examn- 
ples of such situations are: 


e Invoking backup links 
® Restoring normal links after repairs 
° Performing tests 


The subject of testing is covered in subsequent sec- 
tions. At this time, it should suffice to review the 
above examples and think about the issues of: 


®  Decumenting the procedures 


® Making the documentation available to the network 
operators in the most convenient manner 


The IBM Program Product ‘Network Communications Control 
Facility (NCCF)' offers an important function that can 
be used to advantage for this purpose in an interactive 
way. Please refer to Chapter 4, section 4.2.1 for 
examples of the use of CLISTs. This facility is flexi- 
ble enough to enter an entire Operators' Guide on line. 


2.2.2 : SAMPLE INSTALLATION TESTS 


INTRODUCTION 


In this section we list a collection of tests for an 
SNA installation. These tests are grouped in the two 
classes: 


- Tests relating to Service Aids 
~- Tests relating to Error Recovery. 
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TESTS RELATING TO SERVICE AIDS 


TEST OPERATION 


1.— Test Link Level 2 Test. 
(with an active PU) 


Activate the PU 
~ Issue the command LL2 Test 
It should fail 


Test Link Level 2 Test. 
(with an inactive PU) 


Inactivate the PU 
—- Issue the command LL2 Test 

~ Results should be displayed 
Use NPDA if in error 

te: Not supported by all PU's. 


No 


Tast VTAM Trace. 
( I/O and buffer) 


Start VTAM and NCCF 
Start Application 
- Trace application (from NCCF) 

Trace terminal( from NCCF) 

— STOP TRACE (from NCCF) 

Symptoms: The trace commands should be 
accepted. Displays should indicate that 
traces are on. 


Print VTAM Traces using 


Use Traces of previous test (N. 3) 
local batch job and printer. 


—- Start TPRINT Batch Job (VSE) 
—- Use AMDPRDMP utility if MVS 
—- Print Job Output 

Review Output 


Print VTAM Traces using 
RJE to submit and print. 


Use Traces of previous test (N. 3) 
- Submit TPRINT Job from Central site 
—- Or AMDPRDMP utility if MVS 

—- Examine Output at central site 
Print Output 


Test IMR on 3705 to Remote - Establish net 
— Begin IMR on 3705 link 
- Cause temporary errors 


Use NPDA to review errors 


Establish net 
~ Press IPL button on 3705 

- Dump and Load should be Auto 
—- Observe symptoms . 
Recover Net 


Test NCP Dump/Recovery 


8.—- Test NCPDUMP Print Utility. —- Print NCPDUMP from Test Number 7 
— Examine Output 


9.— Test NPDA (Remote system) —- Establish session with Local NCCF 
— Start C-D session with Remote NCCF 
— Enter NFDA 

—- Set domain to Remote NCCF 

—- Preview errors on Remote system 


10. Print Remote system log at 
Central site. 


—- Establish C-—D session — RJE 

— Submit job at central site 

—- Job should be sent to remote site 
~ Output should come to central site 
11. Print Logrec in remote system. —- Establish C-D session — RJE 

— repeat previous operations 

~ Output should go to Power queue 


— Deactivate the PU 
—- Start Adapter Trace 
~- Activate PU 


12. Test Communication Adapter Line 
Trace. 


- STOP Trace 
13. Print Communication Adapter Line — Print data from the previous Test(N.12) 
Trace. 
14. Test SMS (VTAMBUF) on VSE. —- Establish C-D sessions (NCCF) 


— Start SMS Trace (NCCF) 
— Start SDAID with VTAMBUF (Taped }(DCCF) 
— Stop SDAID 

—- Print Output 


15. Test I/0 activity Trace (VTAMIO). ~ Start SMS Trace (VTAM/NCCF ) 
— § SDAID with VTAMIO (Tape]) 
—- Stop SDAID 


—- Print Output 


- Establish NCCF/DCCF SPSSIUT 
- Use PDZAP to change Modetab 

- Deactivate resource 

— Reactivate and trace Bind for change 
verification. 


16. Test PDZAP from NCCF/DCCF. 
~ Setup and test DOSVSDMP 


17. Test BDOSVSDMP. 
(Refer to LY33-9101 ppv24) —- Print Dump 
18. Test ACFTAP. —- Use ACFTAP to print Line Trace 
- Use ACFTAP to print I/O Buf Data 
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TESTS RELATING TO ERROR RECOVERY 


1.— Test to validate Local Modem. Deactivate C-D Link 
(Remote error symptoms ) Turn off local (NCP) modem 
Activate C-D Link 
Note error 
Fix and retry 


Test to validate Local Modem in Activate C-D Link 


use. Turn of f local modem 
Note error 
Fix and retry 


Open Link, validate ERP. Activate C-D Link 

Remote error symptoms | Open Link | 
Observe errors at 3033 and VSE 
Fix and note recovery 


- Establish TSO session 

~ Send large output from OS to VSE 
— Observe TSO response times 

~ Note errors if they occur 

Use VSE/PT to observe performance. 


Test of Network Capacity. 
(It is for Performance/Capacity) 


5.- Open Link, prior to activation. — Inactivate the link 

- Open the Link 

- Activate Link and PU 

~ Note should indicate Pending 


- Should be no problem at 4331 


Deactivate the C-D link (MVS) 
— At 4331, deactivate C-D link 
- Turn off 4331 modem 

—- Activate C-D link at 4331 

—- Activate C-D link at MVS 


Power off of remote modem, inac— 
tive line. 


Remote modem failure with 
active link 


Activate C-D session 
- Turn off remote modem 
-— Note errors . 
—- Turn on remote modem 
Activate Link at 4331. 


errors, CPU failure Establish running net 
~ IPL 4331 

—- Restart 4331 

- Monitor symptoms at host 


Take Host recovery action 


VTAM failure 


- Establish running net 

—- Cancel VTAM 

- Observe symptoms at 4331 
~ Observe symptoms at 3033 
Recover net 


power failure Establish running net 
~- Cancel power 

~- Observe symptoms at 4331 

~ Observe symptoms at 3033 
Recover net, wait 1 minute. 
OCCF failure. ~ Establish running net 

—- Cancel OCCF 

~ Observe symptoms at 4331 
- Observe symptoms at 3033 
Restart OCCF 


NCCF failure. ~- Establish running net 


~ Close NCCF IMMED (DOS console) 
—- Observe symptoms at 4331 

— Observe symptoms at 3033 
Restart NCCF/OCCF 


Establish running net 

Establish TSO session 

—- Power off local 327% 

—- Observe symptoms in network (use 
display) 

Check NEDA (VSE), Power on. 


local 327X failure. 


remote 327X failure. Establish TSO session 

—- Power off remote 327X on VSE 

— Observe symptoms in network (use 
display) 

Power on and validate recovery. 
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VSE application failure. 


VSE to VSE, 3705 failure. 


Line printer. 


Simulate disk drive failure. 


Remote system power failure 


ACF/SNA SYSTEM PROBLEM DETERMINATION GUIDE Vol. I 


Establish CICS sessions 

Cancel CICS in VSE 

Observe symptoms in network(use NCCF) 
Restart CICS 

Observe recovery. 


Establish net 

Establish VSE to VSE session 
Issue V NCP,INACT,;R 

Observe symptoms 

Recover VSE to VSE session. 


Start printer job 
Stop printer 
Observe messages 
Start printer. 


Backup system pack 

Establish net, start utility 
Disable system pack 

Restore tape to alternate pack 
Restart utility. 


Establish net 

Power donn CPU 

Power down local devices 

Observe errors at 3033 

Power up and restart system, observing 
any recovery problems. 
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2.2.3 


> INSTALLATION TEST PLANS 


MASTER SCHEDULE 


Test: Page of 


Test Test Date Date 
Number Started | Completed 
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UNIT TEST 


Test Number: Date Started : 


Date Completed: 


Test Description: 


Error Simulated: 


Test Procedure: 


TEST RESULTS 


Test Number: Date Started : 


Date Completed: 


Test Description: 


External Symptoms: 


Error Messages: eee eee ae eee) 


ACF/VTAM Display Verification (Before): 
LU Status: PU Status: Line Status: 
APPL Status: NCP Status: 

ACF/VTAM Display Verification (After): 
LU Status: PU Status: Line Status: oe, 


APPL Status:_ NCP Status: 


Recovery Procedures: 
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ENTER USER NOTES HERE: 


CHAPTER 3 : PROBLEM DETERMINATION/ISOLATION PROCEDURES 


This section of the guide contains typical Problem Determination Isolation Procedures (PD/IPs) for 
many of the problems which may be encountered in an SNA system. The PD/IPs contain procedures that 
should be used to isolate the failing sequence or component. 


Preceding each Problem Determination/Isolation Procedure (PD/IP) is a list of commonly experienced 


problems and their causes. <A review of these typical installation problems may isolate the problem 
before the PD/IPs are entered. 


CONTENTS 

3.1 : GENERAL PROBLEM ISOLATION HINTS . . . 2. 2. 2 © © © © © © © e© © © 52 
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3.1: GENERAL PROBLEM ISOLATION HINTS 


There are some basic ground rules for doing problem isolation in a 
VTAM based SNA network. This section establishes the basic isolation 
steps that are prerequisite for most of the problem datermination pro- 
cedures that follow this section. 


As a general rule, the interactive tools are preferred over the batch 
ones, specifically: 


¢ Network Communication Control Facility (NCCF), see Section 4.2.1. 


e Network Problem Determination Application (NPDA), see Section 
G.2.2. 


© Network Performance Analyzer (NPA), see Section 4.3.2. 


Insufficient VTAM buffer speci fica- Now with the dynamic buffering of Release 3, these problems are minimized. 
tions Only watch the IO buffers. 
Insufficient virtual storage DOS/VSE - VTAM uses VPBUF for dynamic storage requirements such as 
| : ‘OPNDST', 'CLSDST', and building of major node resource definition tables 
(RDT). 
Insufficient system resources During activation, deactivation, and error recovery VTAM requires addi- 


tional virtual storage. This can increase the paging rate for the system. 


Incorrect VTAM definitions Most SNA network problems are due to incorrect network definitions. 
Installation guides should be used for initial network definitions. SNA 
Product Installation Guide (G320-6028)} 1s recommended. 


Sessions/Routing anomalies One general recommendation is to have ready several sessions with different 
possibilities of: 
® Transmission groups 
Ad Explicit routes 
e Virtual routes — 
® Priorities 


and when having a session/routing problem, determine where the fault is by 
activating another similar session. 


Problem Isolation Steps 


Reference 
Page(s) 


Description 


VTAM buffer utilization must always 
be monitored. Start SMS trace for 
VTAM buffers. 


Or also display VTAM buffers with 
the command D NET,BFRUSE). 


RNIO and BUFFER traces’ should 
always be started for the NCP when 
isolating problems with devices 
attached to the NCP. 


If ACF/VTAM, the VTAM internal 
trace should be used for random 
errors or if all activity is to be 


monitored. (A previous level of 
internal trace allows D 
NET,MSGMCD=YES which gives’ the 


names of VTAM modules that origi- 
nated the messages). 


Examine the console log. 


Print the VTAM network definition 
at the time of failure. 


Performance problems 


Documentation required for IBM 


4-114 


5-17 


4-114 
4-133 
6-1 


4-114 


4-140 


Shortage of VTAM buffers is the most common problem in 
the installation or operation of a VTAM2 based SNA sys- 
tem. 


The display will indicate condition of ACF/VTAM 
buffers. Buffer use should be monitored for abnormal 
buffer use, steady-state, and expansion frequency. 


All errors for lines, physical units and for the NCP 
can only be detected by tracing the NCP (Cor using 
NPDA). 


All activity with VTAM will be recorded. IO and Buffer 
traces are not recommended when running internal trace. 


The console log is the most important debugging tool 
available for problem isolation. Always save the con- 
sole log for validating previous operational problems 
or failing sequences. 


Many network problems can be resolved by examining the 
VTAM definitions and comparing them with good samples. 
The SNA Product Installation Guide (G320-6028) is a 
good reference. 


The interactive tool NPA is useful to determine quickly 
if the problem is in the network. 


Special Instructions 


Trace reports. 


Console log. 
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Copy of VTAMLST or B.book for G-140 
DOS/VS5E 


3.2: VTAM WILL NOT INITIALIZE 


SYMPTOM: 


Insufficient buffer specifications 


VTAM partition/region virtual size 
not adequate 


VTAM partition real allocation too 
small (DOS/VSE) 


VTAM not installed correctly 


6G624~-1514-1 
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VTAM indicates that it cannot be 
tialized or VTAM does not indicate at 
the console that it has been 
initialized. Message ISTO20I(5A20I1) 
‘VTAM INITIALIZATION COMPLETE' is not 
displayed. 


ini- 


VTAM buffer specifications are dependent on the individual network defi- 
nition. A certain number of buffers must be available for VTAM to activate 
the network. ACF/VTAM buffers should be computed for the steady state, then 
allow VTAM to expand for unusual conditions, such as startup, shutdown or 
an application being cancelled. 


In all operating systems except MVS, VTAM's partition must be large enough 
to contain all program modules and buffers. Check the appropriate storage 
estimates reference manual and confirm that the region or partition size is 
large enough. NVS requires an initial startup of approximately 1024k. This 
value should be specified in the region parameter. 


DOS/VSE requires that the real storage allocated to a partition be equal to 


or greater than VTAM's fixed buffer requirements plus VTAM's fixed module 
requirements. 


The operating system must be generated to include VTAM. 


A full sysgen is 
required. 
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(Reference 


Description 


Try to initiate VTAM using a mini- 
mum startup procedure. File member 
ATCSTROO in SYSI.VTAMLST (B.book 
for DOS/VSE) with only CONFIG=06 
and SSCPID=01 specified. Nexts 
file a member ATCCONOO consisting 
of one blank card in SYS1.VTAMLST 
(B. book for DOS/VSE). 


If the minimum startup procedure 
does not work, check the sysgen to 
confirm that VTAM has been included 
in the system correctly. 


If the minimum startup procedure 
works, check that the region or 
partition size 1s sufficient. 


Recheck the startup parameters you 
are using. 


Documentation required for IBM 


| Page(s) 


4-140 


If VTAM initializes with this minimum == startup 
procedure, we Know VTAM was installed in the system 
correctly. 


VTAM must be included in the system at sysgen time. 


This is one of the most common causes of this problem. 
Recalculate the storage requirements for your config- 
uration. 


Insufficient buffers will cause VTAM to initialize ina 
minimum configuration but fatl to initialize with your 
network configuration. Recheck your buffer calcu- 
lations. Verify that there are no missing commas in 
the startup member or the onfiguration member being 
used from VTAMLST (B.book in DOS/VSE}. Reconfirm that 
continuation characters are in column 72. 


Special Instructions 


Dump of VTAM partition/region 


Dump of CSA (MVS) 
Console log 


Copy of VTAMLST or 8B.book for 
DOS/VSE | 


Check VTAM buffer pools in dump to see if any pools are 
depleted 
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3.3: VTAM WILL NOT TERMINATE 


SYMPTOM: 
'VTAM IS NOW INACTIVE' message is not 
received after entering 'Z NET' command. 


Application program still active VTAM will not terminate if an application program has an open ACB. Appli- 
cations should either be cancelled from the operator's console or should 
issue a CLOSE ACB macro when their TPEND exit is driven. 


Insufficient VTAM buffers VTAM requires buffers to terminate. If there are insufficient buffers 
available, VTAM will not be able to terminate. Check your buffer specif1- 
cations or take a dump and check the buffer pools for depletion. 


Resource is hung VTAM attempts to terminate all sessions in an orderly fashion. If no 
response is received to the termination sequence for a node, VTAM will wait 
and will not terminate. 


If a logical unit is in session with an application program, the logical 
unit will not deactivate regardless of the VTAM vary tnactive modifier 
used, until the application does a 'CLSDST'. If the application does not 
have a LOSTERM exit routine, the session must be terminated by an applica- 
tion operator command, or by terminating the application program. Refer to 
the VTAM operator commands section of this manual to see what each of the 
VTAM vary command modifiers do. VTAM will not terminate until all active 
sessions are terminated. 


Operator reply outstanding If there is a TOLTEP operator reply outstanding, VTAM will not terminate. 


Application partition/region size If there is not enough storage available in the application region or par- 
insufficient tition for CLSDST processing, the application program may not be able to 
terminate. This prevents VTAM from terminating. 
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Reference! 


Description 


Display status of each application 
using VTAM display commands. 


Display the status of the NCP to 
see which lines are still active. 
D NET,E,ID=ncpname 


Display the status of the active 
lines and determine which PUs are 
active. D NET,E,ID=Linename 


Display the status of the active 
PUs to determine which LUs are 
active. D NET,E,ID=puname 


Issue a vary inactive with the 
force option to the active logical 
units one at a time until VTAM ter- 
minates. V NET,INACT,F,ID=luname 


Page(s) 


5-4 


5=5 


5-27 


This display of the applications will indicate if any 
sessions still exist. If the display indicates there 
are nodes in session, display the nodes. If the status 
of the node is ACT, the application has not issued 
'CLSDST'. Issue the VTAM vary inactive command with 
the immediate modifier for the node. This will drive 
the application's LOSTERM exit, which should issue 
'CLSDST'. If the display of the node indicates its 
status is ACT/U, the application has issued 'CLSDST', 
but VTAM has not completed the UNBIND. In this case, 
enter 'V NET,INACT,F,ID=nodename 

(VTAM vary inactive command with the force modifier) 
to free the node. 


Each application program must close its ACB, or be 
cancelled, in order for VTAM to terminate. The Z NET 
command drives each active application's TPEND exit 
routine with a reason code of 0. The TPEND exit rou- 
tine may or may not close its ACB. The Z NET,QUICK 
command drives each active application's TPENP exit 
routine with a reason code of 4. In this case the 
application should issue a 'CLOSE' macro for its ACB. 


If no application sessions exist, VTAM is probably hung 
trying to free one of its own sessions. Find the lines 
that are marked active. 


The objective is to find the lowest level node that is 
hung and to issue a '‘'V NET,INACT,F,ID=' against it. 
This should free the system. 


This display will give you a list of active logical 


units on this PU. 


Determine which logical unit was hanging up the termi- 
nation process and investigate further. 
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Problem Isolation Steps Reference Description 
(continued from last page) Page(s ) 


Issue Z NET,CANCEL if this feature 5-25 IF Z NET,CANCEL is not available, the system will prob- 

1s available ably have to be re-IPLed to terminate VTAM. This situ- 
ation is not normal, and the IBM Program Support 
Representative should be contacted. 


| Documentation required for IBM Special Instructions 


Dump of the VTAM partition/region The VTAM partition will be dumped if the Z NET,CANCEL 
command is issued, providing the NET procedure contains 
a SYSABEND statement. 

Dump of CSA (MVS) 


Console log 
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3:4 3: VTAM ABENDS OR WAITS 


SYMPTOM: 
VTAM ABENDS or waits during operation. 


Insufficient Buffers The most common cause of VTAM waits ts a depletion of the I/0 buffer pool 
(IOBUF in NVS, and LFBUF in DOS/VSE). If a terminal has a malfunction in 
which it continuously sends in data, the I/O buffers will quickly become 
exhausted and VTAM cannot do any further processing. If the number of I/0 
buffers is small, a READ FULL BUFFER command to a display can cause this 
also. On OS/VS systems, if the priority of GTF is low, and the VTAM trace 
activity is highs, the trace data may back up in the I/0 buffers and finally 
deplete the pool. 


If the BUFLIM and BUFFACT values exceed the amount of buffers specified 
(VTAM 2 only), VTAM buffer depletion will take place. 


VTAM not authorized VTAM will abend if the main task and all subtasks are not authorized by 


placing them in 0S/VS member IEAAPFxx (MVS ONLY). SYSI1.VTAMLIB and the NCP 
load library must be authorized. 


VTAM allocation for DOS/VSE parti- When operating a subtask in VTAM's partition, the partition size should be 
tion too small increased by the value the subtask would require if running tn its own par- 
tition. 


Subtask abends Any program that operates as a VTAM subtask, such as NCCF(DOS) or the BIP 
| (Batch Transfer Program), can contaminate VTAM's storage, causing it to 
abend. ? 


API (VTAM Application Program On MVS systems, certain VTAM modules should be made resident. Chapter 8 of 
Interface) routines not resident the MVS VTAM System Programmer's Guide (GC28-0688) discusses the PAK and 
FIX lists (IEAFIXnn and IEAPAKnn in SYS1.PARMLIB). 


Bad application | VTAM application programs can cause VTAM to abend by improper usage of VTAM 
| control blocks (DOS/VTAM only). 


Problem Isolation Steps Reference 


Description 
Page(s) 
On OS/VS systems, verify that Refer to SNA Product Installation Guide (6320-6028), 
libraries containing VTAM, VTAM ; for sample JCL to authorize these libraries. 


subtasks, NCP load modules, and NCP 
utilities are authorized. 


Review console log for a subtask 


The abending program should be placed in another parti- 
abend. 


tion/region until the problem can be resolved. This 
will often allow VTAM to continue operation. 


Examine application program logic If a new application has just been added to the system, 
for routines that reuse an active 1t should be suspect. 
RPL or that free the storage asso- 

ciated with an active control 

block. 


Documentation required for IBM 


Special Instructions 


Dump of VTAM partition or address VTAM being a system task, will dump to the SYS1.DUMPxx 
space dataset. 


Dump of CSA (MVS) 


Console Log 
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3.5 : VTAM COMMANDS DO NOT WORK 


SYMPTOM: 


VTAM does not appear to be accepting any 
operator commands 


Insufficient buffers VTAM requires that buffers be available to create the control blocks which 
represent operator commands. 


Insufficient storage On OS/VS systems, VTAM does a GETMAIN for CSA in order to build a control 
block used for operator commands. Also, a 'VARY' command may result in the 
application program having to issue certain VTAM macros. If there is not 


enough free storage in the application partition, the command may not com- 
plete. 


Application not issuing CLSDST A 'V NET, INACT' command does not complete until the application program in 
session with the logical unit issues a 'CLSDST' macro. 


Operator error Improper use of VTAM operator commands can cause depletion of buffers used 
by VTAM for commands. 


The ‘V NET,INACT' command without a modifier (I or F) is intended to be 
used to prevent new sessions, not to terminate an existing session. VTAM 
will only schedule the action, it will not take action until the session is 
terminated by the application. If the session 1s to be ended at once, 
either the ‘I' or the 'F' modifier should be used. 


The '‘'V NET,INACT' command with the immediate (I) modifier will drive the 
application's LOSTERM exit. It is the responsibility of the application to 
issue ‘'CLSDST' to end the session. Only when the application issues 
'CLSDST' will the vary command complete. 


The 'V NET,INACT' command with the force (F) modifier will also drive the 
application's LOSTERM exit. When the application issues 'CLSDST', VTAM 
will respond immediately and not generate I/0 for the resulting SNA 
CLEAR/UNBIND sequence. If the application does not issue 'CLSDST' in its 
LOSTERM exit, or does not have an LOSTERM exit, the vary command will not 
complete. 


Problem Isolation Steps 


If VTAM does not indicate that the 
command has been accepted, then 
VTAM 1s probably hung up. 


If VTAM indicates the command has 
been accepted, and the command was 
a VARY, issue a ‘VARY 
NET, INACT,ID=nodename,I' command. 


If the vary was issued on a higher 
level node than the logical unit or 
terminal, issue VTAM display con- 
mands with the ‘every’ option to 
the higher level node. 
Then issue a VTAM display on the 
logical units or terminals. 


Issue a VTAM 'V NET,INACT' command 
with the force (F) modifier if the 
display indicates ACT/U for the 
logical unit. 


Documentation required for IBM 


Reference 
Page(s) 


DUMPS 


5-27 


Description 


A dump of VTAM's partition/region should be taken. The 
first thing to be suspected is buffer pool depletion or 
a VTAM internal problem. 


The 'V NET, INACT' without a modifier does nothing if an 
application is in session with a node. In this case the 
node will only be varied inactive when the session has 
ended, because the application has issued 'CLSDST'. 
However, the '‘V NET,INACT' with the immediate option 
will schedule the application's LOSTERM exit routine. 
If the application issues 'CLSDST' in its  LOSTERM 
exit, the vary will complete. 


If the status of the logical units or terminals is 
ACT/U, it means that the application has issued a 
'CLSDST' macro, and a path error to the logical unit or 
terminal probably exists. If a status of ACT and ALLO- 
CATED to a application exists, we Know the application 
has not issued a 'CLSDST'. If the application cannot 
be made to 'CLSDST' the LU or terminal 1t may be neces- 
sary to cance: the application. 


This should free the logical unit or terminal hung with 
the ACT/U status. 


Special Instructions 


Dump of CSA (MVS) 
Console log 


Dump of application 


Dump of VTAM's partition/region 
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The sequence of commands issued is necessary. 


If the display commands show that the application never 
issued 'CLSDST' 


Check for buffer pool depletion. 
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3.6 =: LOCAL DEVICE WILL NOT ACTIVATE 


SYMPTOM: 
A local SNA controller will not activate 
at startup time, or when a 'V NET,ACT' 
command 1s issued. 


¥NOTEX Here ‘local SNA' means local-channel-attached SNA devices (IBM 3274-14). 
The IBM 3272 and IBM 3274-1B are not SNA devices! The 'SNA appearance' of 
these devices (as well as BSC 3271s, above the link level), ts implemented 
wholly in VTAM code. The SNA appearance of SDLC 3271/5 devices (again, 
above the link level), is implemented in NCP/VS code. Keep this in mind 
when going through the PD/IPs. In spite of the above, this FD/IP still 
applies to IBM 3272s and IBM 3274-1Bs, with the following exceptions. The 
Immediate (I} modifier is the only valid modifier (other than none) on the 
VTAM VARY command. This is because ACT/B; INA/B, INA/U; etc. states should 
not occur for these devices, because these physical unit functions are 
implemented in VTAM code, as stated above. 


Inadequate VTAM buffers If VTAM has insufficient buffers, it will not be able to activate a local 
device. The IOQBUF(BUFSIZE) parameter must equal the UNITSIZE value in the 
NCP HOST macro definition. 


YIOBUF size (3274) VTAM definition of UNITSZ must nave minimum value of 80, and value of IOBUF 
is equal to MAXBFRU. . 


System allocation error | A system allocation error will occur if the device is offline, allocated to 
| another access method, or not included in the sysgen. <A system allocation 
error will also occur if the unit address in the VBUILD definition is not 

the actual ccu address of the 3270/3790. 


ISTATUS of PU If ISTATUS=INACTIVE is coded on the PU macro, the physical unit will not 
activate when the VBUILD major node is activated. 


Problem Isolation Steps Reference 


Description 


Page(s ) 


Review VTAM buffer specifications. Ensure that block size of IOBUF is at least 300 bytes, 


if local 3790 systems are included in the system. The 
minimum number of IOBUF buffers specified should be tuo 
times the sum of the MAXBFRU values coded on the 3790 
PU f macros, the VBUILD major node, and the MAXBFRU 
values coded on the HOST macros of all the local NCPs. 


Review LOGREC MDR records 4-89 If I/O errors occurred, the MDR records in LOGREC may 
be helpful in isolating the problem (also NPDA). 

Run VTAM I/O ana buffer traces for 4-114 Check to see if an SNA 'ACTPU' command is sent to the. 

the physical unit, along with GTF 4-133 3790, and if a positive response is received. 

I/O and SIO traces. 6-1 


Documentation required for IBM 


Special Instructions 


Console log 
MDR records 4-89 


Traces gathered 
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3.7: LOCAL DEVICE WILL NOT DEACTIVATE 


SYMPTOM: 
A local SNA will not deactivate at net- 
work shutdown time, or when a ='V 
NET,INACT' command is issued. 


XNOTE* Here ‘local SNA' means local-channel-attached SNA devices (IBM 3274-14). 
The IBM 3272 and IBM 3274-1B are not SNA devices! The ‘SNA appearance’ of 
these devices (as well as BSC 3271s, above the link level}, is implemented 
within the VTAM code. The SNA appearance of SDLC 3271/5 devices (again, 
above the link level), is implemented in NCP/VS code. Keep this in mind 
when going through the PD/IPs. In spite of the above, this PD/IP still 
applies to IBM 3272s and IBM 3274-1Bs, with the following exceptions. The 
Immediate (I) modifier is the only valid modifier (other than none) on the 
VTAM VARY command. This is because ACT/B, INA/B, INA/U, etc. states should 
not occur for these devices, because these physical unit functions are 
implemented in VTAM code, as stated above. 


Inadequate VTAM buffers If VTAM does not have sufficient buffers, it may not be able to deactivate 
. 7 the device. | | , 


LU still in session If a logical unit is in session with an application program, the logical 
| unit or local 3270 will not deactivate until the application issues 
‘CLSDST' to terminate the session. If a VTAM vary command with the tmmedi- 
ate modifier is issued for the major node, the application's LOSTERM exit 
will be driven, for any existing sessions, and should issue ‘'CLSDST' to 
terminate the session. If the application does not have an LOSTERM exit, 
or is not issuing 'CLSDST', the local device will not be able to 
deactivate. 


Problem Isolation Steps 


Issue the VTAM display command with 
the every option, for the physical 
unit. For local 3270s, display the 
terminal. 


If the status of any logical unit 
or terminal is ACT, issue a VTAM 
vary command with the immediate 
modifier to the physical unit, or 
to the terminal, for local 3277s 
attached via a 3272. 


If the status of the logical unit 
is ACT/U, issue a VTAM vary inac- 
tive command with the force (F) 
modifier. 


If the status of any logical unit 
was ACT/U, and the deactivate hang 
up is reproducible, run VTAM's I/0 
and buffer traces on the logical 
unit. 


Documentation required for IBM 


Reference 
Page(s} 


5-27 


Description 


If the status of any logical unit or terminal is ACT, 
the application has not issued 'CLSDST' to terminate 
the session. 


If the status of any logical unit is ACT/U, the appli- 


cation has issued 'CLSDST', but a response to the SNA 
CLEAR and UNBIND command sequence has not been 
received. & VTAM vary command, with the force 


modifier, should clear this condition. 


This will drive the application's LOSTERM exit, and the 
application should issue ‘CLSDST' to terminate the ses- 
Sion. If the application does not issue '‘'CLSDST', or 
does not have an LOSTERM exit, the device will not 
deactivate. Either use an application operator proce- 
dure to force 'CLSDST' to be issued, or the applicatian 
may have to be cancelled. 


This should clear the condition. 


Check to see if the SNA CLEAR and UNBIND commands were 
sent, and whether a positive response was received. 
This will indicate whether the problem is in VTAM or in 
the physical unit. 


Special Instructions 


Console log 
Copy of VTAMLST/B.book 


Traces gathered 
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3.8 +: LOCAL DEVICE ACTIVE BUT NOT COMMUNICATING 


SYMPTOM: 


& local SNA LU can be activated and 
establish a session, but no data trans- 
fer occurs. 


¥NOTEX Here ‘local SNA' means local-channel-attached SNA devices (IBM 3274-14). 
The IBM 3272 and IBM 3274-18 are not SNA devices! The ‘SNA appearance’ of 
these devices (as well as BSC 3271s, above the link level), is implemented 
within the VTAM code. The SNA appearance of SDLC 3271/5 devices (again, 
above the link level), is implemented in NCP/VS code. Keep this in mind 
when going through the PD/IPs. In spite of the above, this PD/IP still 
applies to IBM 3272s and IBM 3274-1Bs, with the following exceptions. The 
Immediate (I) modifier is the only valid modifier Cother than none) on the 
VTAM VARY command. This is because ACT/B, INA/B, INA/U, etc. states should 
not occur for these devices, because these physical unit functions are 
implemented in VTAM code, as stated above. 


Inadequate VTAM buffers If VTAM has an insufficient number of I/0 buffers, it may not be able to 
communicate with the local device. 


Local 3277 not in session | A local 3277 connected via a 3272 must be in session with an application in 
order for the system available light to come on. The light should stay on 
until a Keyboard command is entered. The device status will show active, 
even if it is not logged on to an application. 


Problem Isolation Steps Reference} Description 


Page(s) 


Issue a VTAM display command for 5-7 Check to see if the device is allocated to an applica- 

the local 3270. tion. If it is not, use the VTAM vary command with the 
logon option to allocate it to NETSOL or to the appli- 
cation desired. 


If the problem can be repeated and 4-114 Check if an attention interrupt is generated when the 
the display indicates the device is 4-133 Enter key ts hit. If an attention interrupt 1s not 
allocated to an application, run 6-1 generated, a hardware problem should be suspected. If 
VTAM's buffer trace for the device. the attention interrupt is generated, but an SIO is not 
Also, start a GTF I/O and SIO trace being issued, then VTAM is not doing a read. A VTAM 
(OS/VS) or a VTAM trace (DOS/VSE) buffer shortage should be suspected. If an SIO is gen- 
for the device. erated, then VTAM has issued a read, and the buffer 


trace entries will indicate whether the application is 
receiving the data. A C/L entry indicates that the 
application has issued a RECEIVE macro and that VTAMN 
has moved the data to the application's data area. 


Documentation required for IBM Ref. Page| Special Instructions 


Console log 


Traces gathered 
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3-9: LOCAL DEVICE SESSION TERMINATES ABNORMALLY 


SYMPTOM: 
A local SNA LU can be activated and com- 
municated with, but the session termi- 
nates during normal operation. 


¥NOTEX Here ‘local SNA‘ means local-channel-attached SNA devices (IBM 3274-14). 
The IBN 3272 and IBM 3274-1B are not SNA devices! The 'SNA appearance’ of 
these devices (as well as BSC 3271s, above the link level}, is implemented 
within the VTAM code. The SNA appearance of SDLC 3271/5 devices (again, 
above the link level), is implemented in NCP/VS code. Keep this in mind 
when going through the FPD/IPs. In spite of the above, this FD/IP still 
applies to IBM 3272s and IBM 3274-1Bs, with the following exceptions. The 
Imnediate (I) modifier is the only valid modifier (other than none) on the 
VTAM VARY command. This 1s because ACT/B, INA/B, INA/U, etc. states should 
not occur for these devices, because these physical unit functions are 
implemented in VTAM code, as stated above. 


Application program terminates the In VTAM Level 2 if the product of BUFLIM (coded on the LOCAL or LU macro), 

Session and BUFFACT (coded on the application major node defined in 
VTAMLST/B.book), is exceeded by the amount of input data queued by VTAM 
from a terminal or logical] unit, VTAM will free the buffers containing the 
data, and drive the application's LOSTERM exit. The application should 
issue 'CLSDST' in its LOSTERM exit. 


Storage shortage On a DOS/VSE ACF/VTAM system, if the application dees not have a RECEIVE 
macro outstanding, VTAM will place the data received in VPBUF. If VPBUF is 
short on storage, then the session will be terminated; there 1s no ACF/VTAN 
dynamic buffer allocation for VPSUF. 


On OS/VS versions of ACF/VTAM, if the application does not have a RECEIVE 
macro outstanding, VTAM will place data recaived from a legical unit in the 
application's region. If storage is not available in the application's 
region, VTAM will free the data received, issue an SNA 'CLEAR' command to 
the logical unit, and drive the application's LOSTERM exit routine. 


LOCAL DEVICE SESSION TERMINATES ABNORMALLY 


(continued) 


Application program error The application may be terminating the session because of an error condi- 


tion. For example, a no-data-entered timeout condition on TSO, will cause 
TSO to issue 'CLSDST', and terminate the session. 


Test Request key If the Test Request Key is hit on a local 3270, VTAM drives the applica- 
tion's LOSTERM exit, and the application may terminate the session. A zap 
is available to prevent this from occurring. Refer to the VTAM/NCP problem 
isolation information section of this manual. 
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Problem Isolation Steps Reference Description 
Page(s } 
For local 3270s, review the termi- If the Test Request key was hit, it ts the reason for 
nal operator's procedures prior to session termination. If a very large screen of data 
the failure. was entered and/or the reset and enter Keys were 


pressed several times, the BUFFACT/BUFLIM values may 
have been exceeded, thus terminating the session. 


Review application logs or traces. If the application recorded feedback codes when its 
LOSTERM exit was driven, they may help to isolate the 
problem. 


For local SNA devices (3274-14), 
see the PD/IP for ‘LOGICAL UNIT'S 
SESSION TERMINATES ABNORMALLY'. 


Documentation required for IBM Special Instructions 


Console log 
Copy of VTAMLST/B.book 4-140 


Application logs or traces If available 


3.10 : APPLICATION DATA LOST 


SYMPTOM: 
An application program can communicate 
with an LU or terminal, but all the 
inbound or outbound data is not 
received. 


Application program error Improper application program coding can cause message truncation or loss of 
messages. For Basic Mode devices, a program should issue a READ-SPECIFIC 
to obtain data in excess of the read-area size in the initial read. The 
same holds true for Record Mode devices and their RECEIVE macros. 


If a program does not have an LOSTERM exit, and the product of BUFLIM and 
BUFFACT is exceeded for the terminal, VTAM will post an active READ or 
RECEIVE RPL with a feedback code, indicating the data was purged. This 
error 1s applicable to BASIC mode terminals for all levels of VTAM and to 
RECORD mode devices for VTAM level 2. Inadvertent specification of the 
‘TRUNC’ option on the RPL or NIB can also cause data to be lost. 
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Problem Isolation Steps | Reference | 


Description 


Page(s) 


Run VTAM's I/O and buffer traces on 4-114 This will indicate whether all the data was received by 

the logical unit or terminal. VTAM and passed to the application program. Comparing 
the data and length in the TPIOS buffer entry, to the 
data and length in the C/L buffer entry will help in 
isolating the problem. 


For ACF/VTAM, if data is being lost This will trace all the Application Program Interface 
between the application and activity, at a detailed level. 
ACF/VTAM, run the ACF/VTAM internal 


trace with the API and PIU options. 


If the data is being lost outbound 4-114 This will determine if the data is being lost by the 
from the host, run an NCP line NCP, or by the logical unit/terminal. 
trace. 


Documentation required for IBM Special Instructions 


Traces gathered 
Terminal output 


Application trace If available 


3.1] : APPLICATION PROGRAM CANNOT OPEN ITS ACB 


An application program gets an abnormal 
return code when it tries to open an 
ACB. 


Inadequate VTAM buffers If VTAM has insufficient buffers, it will reject the application's OPEN 
macro and will not open the application's ACB. The return code to the OPEN 
macro will indicate this condition. 


ACB already active If an application abends, or closes its ACB without doing a 'CLSDST' for 
all of its active sessions, VTAM will terminate all the application's ses- 
sions. VTAM, however, will not indicate that the ACB (to VTAM, the ACB IS 
the application) is inactive until all SNA 'UNBIND' commands have been 
responded to by the logical units. It is possible then, for the applica- 
tion program to restart before VTAM has completed this procedure, because 
one or more logical units may be hung, and may not respond to the SNA 'UN- 
BIND' command. In this case, the application's (second) OPEN ACB request 
will be rejected, and the return code will indicate that the application is 
already active. 


Application program not defined to Application programs must be defined in an active application major node. 
VTAM The correct password must also be provided, if one is specified in the 
"APPL' statement. 


Application program at higher pri- The partition in which the VTAM application program is running must be at a 
ority than VTAM (DOS/VSE) lower priority than the VTAM partition (DOS/VSE only). 
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Problem Isolation Steps Reference Description 
Page(s) 
Issue a VTAM display command to the 5-3 If the application is still active to VTAM, but not to 
application with the every option, the operating system, see the PD/IP for 
and an operating system display for APPLICATION-STICKS-IN-SYSTEM. If the application is 
the job name of the application. shown as active to the operating system, terminate 1t 


or cancel it with a dump. 


Review the application's OPEN ACB The return code should indicate the reason for the 
return code. problem. 

Review VTAMLST/B.book and the Verify that the right names and passwords correspond. 
application's ACB definition. 

Run an SMS buffer pool trace, and 4-114 If the display or trace shows a buffer shortage, review 
attempt to start the application. your buffer calculations. 


For ACF/VTAM, the VTAM buffer pool 
status can be displayed on the net- 
work console. 


Documentation required for IBM Special Instructions 


Console log 

VTAM dump 

Dump of CSA (MVS) 

VTAMLST/B. book | 4-140 


Application log,trace, or dump Check the return code from the OPEN ACB. 


3.12 : APPLICATION PROGRAM STICKS IN SYSTEM 


SYMPTOM: 
An application program cannot close its 
ACB, or the program terminates, and VTAM 
still shows it as being active. 


Hung LU If an application issues 'CLSDST' on all sessions when it is shutdown, it 
may not terminate completely until all the logical units respond to the SNA 
'UNBIND' commands, and the CLSDST's complete. If the application closes its 
ACB, VTAM will terminate the application's active sessions. VTAM, however, 
does not indicate the application is inactive, until a response is received 
for all the SNA 'UNBIND' commands sent to the logical units to terminate 
the sessions. 


Inadequate VTAM buffers If the application does not limit the number of 'CLSDST' macros it issues 
concurrently, VTAM buffer specifications may not be enough to support this 
peak demand for certain buffer pools at application shutdown. 


Inadequate application program par- Each concurrent OPNDST or CLSDST, requires approximately 2.5K of available 

—6tition/region storage in the MVS CSA (Common System Area), and approximately .8K of the 
application's partition in OS/VS1 Release 6. Approximately 1K of storage 
is required in VPBUF for DOS/VTAM. 
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Problem Isolation Steps Reference Description 
Page(s } 

Issue the VTAM display command with 5-3 If any sessions show active, refer to the PD/IPs enti- 
the every option, for the applica- tled "LOGICAL-UNIT-WON' T-DEACTIVATE ' or "BSC 
tion. WON'T-DEACTIVATE'. 

Run an SMS buffer pool trace, or 4-114 If any buffer pool is being depleted increase both its 
display the buffer status on number ('bno'} and threshold ('bth'). 

ACF/VTAM. . 

If no sessions are hung, cancel the This dump will show if any RPLs are outstanding. 


application with a dump. 


Documentation required for IBM Special Instructions 


Console log 


SMS trace or VTAM dump (CSA dump in Check for buffer pool depletion 
MVS) 


Application dump 


3.13 : NCP WILL NOT ACTIVATE 


SYMPTOM: 


VTAM does not indicate that the NCP is 
active. 


Insufficient buffers VTAM will not activate the NCP if there are insufficient VTAM buffers. 
VTAM must have sufficient buffers to allocate for receiving messages from 
the NCP. IOBUF (0S/VS) or LFBUF (DOS/VSE) should be 2 to 2.5 times the sum 
of the MAXBFRU values specified in the HOST macros of the NCPs. An SMS buf- 
fer pool entry will show this is the case. 


Bad NCP generation If an I/O error message is received after NCP loaded message check that the 
BUILD macro properly reflects the type of channel adapters installed in the 
3705. An I/O error will occur after VTAM indicates that the 370X has been 


loaded if the 370X has failing channel hardware or the NCP was generated 
incorrectly. 


Loader utility not in SYS1.LINKLIB Confirm that the NCP load utilities (05/VS: PGM=IFLOADRN, DOS/VSE: PHASE 
CXWMAXI1, CXWMAX2, CXWMINI1, and CXWMINI2) and the initial test utilities 
are available to VTAM. VTAM will abend if SYSI1.LINKLIB or a library con- 
tained in LNKLSTnn does not contain the 370X utilities called for by VTAM 
for initial testing and loading of the 370X. For OS/VS, the SSPLIB data 


set provided on the NCP tape must be added to SYSI.LINKLIB or pointed to by 
LNKLSTnn. 


Down-level loader utility A down-level NCP loader utility may cause an I/O error or may cause VTAM to 
wait for a response that it will never get. 


Internal name of NCP is not the When a message is received saying the vary failed for the NCP, check that 

same as the NEWNAME operand on the the internal name of the NCP is the same as the NEWNAME operand specified 

BUILD macro on the BUILD macro. If the internal name of the NCP is not the same as the 
NEKNAME operand defined in the NCP definition filed in VTAMLST/B.book;, 
VTAM will indicate that it cannot activate the NCP. 


VTAM start definition in error If a continuation on the startup list for VTAM is missing or a comma is 
left off, the NCP activation may fail because of defaults. 
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NCP WILL NOT ACTIVATE 


(continued) 


NCP load module and NCP definition 
in VTAMLST/B.book is not the same 


NCP requires more time to activate 


NCP parameter error 


370X channel adapter subchannel 
addresses not plugged for correct 
range 


Second 3705 channel adapter not 
disabled 


ACF/SNA SYSTEM PROBLEM DETERMINATION GUIDE Vol. I 


When a new NCP is generated and the VTAMLST/B.book definition is updated, 


but the VTAM JCL start procedure does not point to the new NCP, VTAM will 
abend. 


The NCP may still be in the process of activation if some of its lines are 
not operational and a large ENABLTO (enable timeout) value has been speci- 
fied on the BUILD macro. VTAM must activate all lines or wait for the ena- 
ble timeout to occur, before VTAM will indicate that the NCP is active. 
VTAM activates the lines on the NCP sequentially. The data set ready sig- 
nal must come up on the MODEM or the enable timeout value must be reached; 
before VTAM will issue an activate-Link command to the next line. If there 
are many Lines on the NCP which have MODEMs that require time to equalize 
before bringing up data set ready and there are lines without MODEMs at the 


NCP end, the time for VTAM to indicate the NCP is active may be consider- 
able. 


VTAM will reject the request to activate the NCP because of missing parame- 
ters or incorrect continuation control in column 72 of the NCP source deck 
filed in VTAMLST/B.book. 


In a PEP configuration, the 370X channel adapter hardware must be plugged 
for the correct range of subchannel addresses. These addresses must 
include the range of subchannel addresses specified in the LOCHAN-HICHAN 
operands of the BUILD macro. Furthermore, in the case of the Type 4 Chan- 
nel Adapter, the native subchannel address of the 370X must not be in the 
HICHAN-LOCHAN range. 


When PEP is loaded into a 3705 with more than one channel adapter, the 
‘other’ channel adapter must be disabled, else PEP will loop. This channel 
adapter may be manually enabled after the load is complete; this applies to 


-NCP/VS Version 5. 
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NCP WILL NOT ACTIVATE 


{continued ) 


3705 channel adapter not enabled The 3705 channel adapter must be enabled. Be aware that if the NCP abends 
and the 3705 goes into a HARD STOP state, the NCP (or PEP) will vary the 
channel adapter(s) offline INTERNALLY within the 3705 with no visual indi- 
cation of this having happened on the 3705 control panel. The CHANNEL 
ADAPTER ENABLED light(s) on the panel will remain lit! It will not be pos- 
sible to reload the 3705 (load program will program check), without first 
manually disabling the channel adapter(s) at the 3705 control panel, 
selecting the IPL adapter (on 3705s with the IPL channel adapter select 
switch), doing a RESET, enabling the channel adapter(s), and pressing LOAD. 


If you are loading PEP, then disable the non-IPL adapter at this point; see 
comments above. 
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Problem Isolation Steps 
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Reference 


Description 


If VTAM indicates that the acti- 
vation of the NCP was rejected, 
examine the NCP source definition 
in VTAMLST/B.book. 


Set VTAM startup parameters in 
ATCSTRxx to start buffer, I/O ,and 
SMS buffer pool trace. 


Start GTF to trace SIOs and I/0 
interrupts for the 370X, and also 
user (US5SR) data. 


Press reset and load on the 370X 


and start VTAM. 
Issue a VTAM display to the NCP 


tuice and see if the SIO count is 
still increasing. 


Compare the trace output to the 


sample NCP startup in the control 


and flow section of this manual. 


| Documentation required for IBM 


Page(s) 


4-133 


Incorrect continuation control in column 72, or missing 
VTAM-only operands are a common cause of this problem. 


The CONFIG=xx specification in the VTAMLST/B.book mem- 
ber ATCSTRnn must precede the start trace commands or 
errors will result. Member ATTCONxx should include the 
name of the NCP you wish to activate. With these 
startup parameters VTAM will automatically attempt to 


load and activate the NCP. 


The user data will be from the VTAM traces. 


VTAM will automatically attempt to load and activate 
the NCP and traces will be recorded. 


If the SIO count to the NCP is increasing, then ve know 
that the NCP is still in the process of activating. If 
the SIO count is static, then we are probably in a hung 
condition. 


This will indicate how far along the activation process 
has gotten. | 


Special Instructions 


NCP dump 
Traces gathered 


Record 370X control panel lights at 
the time of failure 


4-138 
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3.14 : NCP ABENDS 


SYMPTOM: 
The NCP abends and stores an abend code 
at x'760'. The presence of the abend 
code is indicated by a non-zero value. 
User error | If a new NCP is generated and the user uses the old name, the VTAMOBJ file 
will contain the old description. The user may also have mixed the old RRT 
(NCPxxxxR) with a new NCP. A new NCP should always have a different NEWNAME 
than the old NCP (BUILD macro). 
NCP generation and hardware incom- The physical hardware and the NCP generation must match for channel type, 
patibility model type, and CSB type. The NCP generation manual (GC30-3008) should be 
checked for mandatory parameters. Activation of a line when the 370X does 
not contain the appropriate features may cause an abend. 
PIU too large (inbound only) The product of MAXBFRU and UNITSZ must be greater than the largest PIU han- 
dled by the NCP. NCP will abend with an ABEND code X'0005'. 
Transfer line error The TRANSFR operand of the LINE macro specifies the number of NCP buffers 


that will be filled by the NCP prior to scheduling channel output to VTAM. 
If a generation value is specified that is higher than the NCP default val- 
ue, the NCP will abend. The dafault value should be used for SDLC links 
but should be calculated for BSC lines. Reference the SNA Product Instal- 
lation Guide (6320-6028) ‘Sample NCP Source' for help in choosing the 
transfer value. 
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Problem Isolation Steps Reference 


Description 


Page(s ) 


If the problem can be reproduced, 4-114 It is often necessary to see the sequence of events 
turn on VTAM's I/0 and buffer trac- 4-133 leading up to the hung condition. 

es for all the nodes in the 6-1 

network. Also start the SMS buffer 

trace. 

Take an NCP dump. 4-138 NCP stores an abend code at X'760'. The 3705 handbook 


has a description of these codes and their meaning. 


Documentation required for IBM 


Special Instructions 


NCP dump 4-138 NCP stores the abend code at X'760' if an abend 
occurred. 


CSA dump (MVS) 


Copy of VTAMLST or B.book 


. This trace should not be printed unless requested by 
Trace of all nodes in the network IBM. 


3.15 : NCP WILL NOT DEACTIVATE 


SYMPTOM: 
The message indicating that the NCP is 
inactive 15 not received. 
Lower level node still in session An application program has not issued a 'CLSDST' macro, or a logical unit 
has not sent a response to the SNA UNBIND command. 
Insufficient VTAM buffers If VTAM does not have sufficient buffers, the NCP may not deactivate. 
VPBUF too small (DOS/VSE) If using ACF/VTAM and VPBUF is too small. ACF/VTAM cannot activate the NCP. 
VTAM may also hang if this occurs. 
Deactivation is slow The larger the DELAY operand specified in the HOST macro of the NCP and the 


larger the network, the longer the NCP will take to deactivate. In addi- 
tion, the NCP generates an end-of-day statistical MDR record for each non- 
SNA device and each SNA physical unit and line. This can take a signif- 
icant amount of time. 
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Problem Isolation Steps 


iReference 
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Description 


Issue the VTAM display command for 
the NCP twice. D NET,ID=ncpname 


Issue the VTAM display command for 
each of the applications. D NET, 
ID=application name 


If no application has an active 
session, issue the VTAM command to 
display the NCP with the every 
option. BD NET,ID=ncpname,E. 


Issue the VTAM display command for 
each active line with the every 
option. D NET, ID=linename;>e. 


Issue a VTAM vary inactive command 
with the force option for each 
active PU (VARY 
NET, INACT,F,ID=xxxxx). 


| Documentation required for IBM 


Page(s) | 


5-4 


5-5 


5-27 


You will know that the NCP is still actively in the 
process of deactivating if the SIO count is changing. 


If any application still has an active session with a 
logical unit or terminal on the NCP, the NCP will not 
deactivate. 


This will tell you what lines are still active. 


This will tell you what physical units are still 
active. 


This should allow the NCP to deactivate. 


Special Instructions 


Dump of VTAM partition/region 
Dump of CSA (MVS) 
I/O and buffer trace of all nodes 


Dump of NCP 


4-138 


A dump of NCP is only needed if the traces were 
running. 


3.16 : NCP ENTERS SLOWDOWN 


SYMPTOM: 
The NCP enters slowdown. 


Insufficient buffers If the NCP starts running out of buffers, it will signal VTAM that it is 
entering slowdown. This can be caused by VTAM running out of buffers, and 
not accepting input from the NCP. 


Line trace running If the NCP is tracing a line and the system is heavily loaded, the NCP may 
go into slowdown. 


Tuning This type of problem is usually related to improper tuning of the system. 
NCP operands that affect outbound message queutng on the line can cause 
this: primarily MAXOUT and PACING. PASSLIM, and the ratio of BFRS to MAX- 
DATA may also be culprits. BFRS should be chosen, as close as possible, to 
be wholly divisible into MAXDATA. A segmented or unsegmented PIU always 
starts on a BFRS boundary. Poor line quality can also be a contributing 
factor, due to excessive use of NCP buffers for retransmissions. 


370X too small If the NCP goes into slowdown often, the storage and performance estimates 
of the 370X should be reviewed by IBM. 
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Problem Isolation Steps 


Reference 


Description 


Run a VTAM I/0 trace for a short 
period of time, on all NCP nodes. 


Review NPDA information or 3705 
LOGREC MDR records. 


For ACF/VTAM environments, the tun- 
ing statistics option can provide 
useful information on demand. This 
is a new feature available through 
the ACF/VTAM Program Product. 


Documentation required for IBM 


Page(s) 


From the trace output, determine the average message 
lengths and transaction rates to identify tuning prob- 
lems and/or arrive at storage and performance speci fi- 
cations. 


The records will indicate the number of SIOs and soft 
errors occurring on the links. 


This will assist in identifying tuning problems. 


Special Instructions 


VTAM I/O traces 
Console log 


Copy of VTAMLST/B.book 


3.17 : LINE/LINK WILL NOT ACTIVATE 


SYMPTOM: 
Link does not come up active and cannot 
be varied active. 
MODEM not turned on If the MODEM is not turned on, or the cable is not plugged in, the link 


will not come active. In order to activate a link, the NCP brings up the 
data terminal ready (DTR) lead, and waits for the dataset ready (DSR) lead 
on the MODEM to come up. The ENABLTO operand on the NCP BUILD macro is the 
length of time the NCP will wait for the DSR lead to come up. 


Mismatch between the NCP generation If the wrong line set type is implied (e.g., full-duplex 1H vs. 
and the 370X hardware half-duplex 1D), or the wrong line interface address is specified, the link 
: will not come active. Be sure to consult the Teleprocessing Preinstalla- 
tion Guide, GC30-3020, for the correct set of NCP generation parameters to 

specify for the various device types. 


LIB-Line Set cable mismatch If the wrong cable group is used for the line set, the link may not acti- 
vate. 
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Problem Isolation Steps Reference Description 
Page(s ) 
Run the VTAM I/O trace on the NCP 4-114 An exception response of x'08020000' to the SNA acti- 
and attempt to activate the Link. vate link command indicates a path failure. Check that 
the MODEM is powered on, plugged in» etc. 
If there is a path failure, monitor 4-145 Check to see 1f DSR comes up. 
the MODEM EIA interface leads. 
Look at the 370X  LOGREC MDR 4-89 Look at NPDA and or an MDR record for the line, showing 
records. an enable failure. 


Documentation required for IBM Special Instructions 


Copy of VTAMLST/B.book 


3.18 : LINE/LINK DIAL PROBLEMS 


SYMPTOM: 
Common problems with dial-up facilities. 


SDLC XID mismatch The Station ID of the physical unit must have a match in the PU parameters 
of an active snitched node definition (VBUILD). If the XID does not match, 
or the major node is not active, VTAM will disconnect the dialed-in device. 


VBUILD LU count greater than the VTAM will check that the MAXLU value on the PU macro for the switched line 


NCP MAXLU value is equal to or greater than the number of LUs defined on the PU macro in 
the VBUILD major node. 


PU or LU inactive The physical unit must be active. 


No active application for If there is no active SIMLOGON for the UTERM/VTERM VTAM will also imme- 
UTERM/VTERM diately disconnect. 


Hardware mismatch A MODEM mismatch will also cause the dialing terminal to be disconnected. 
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LINE/LINK DIAL PROBLEMS 


(continued) 
VIDLST or IDLST ID feature mismatch 


Insufficient CSA(MVS), VPBUF stor- 
age(DOS}, or Application 
region(VS1 ) 


Link inactive because of previous 
error 


Application 
logon 


program rejects the 


ACF/SNA SYSTEM PROBLEM DETERMINATION GUIDE Vol. I 


If the VIDLST and or IDLST macro is coded in the NCP, the code of the dial- 
Ing station must match, or VTAM will immediately disconnect. 


VTAM will not be able to honor an application's ‘OPNDST' macro if there is 
insufficient storage in CSA(MVS) for VTAM to create temporary control 
blocks. If a DOS/VSE system, VTAM gets its temporary storage from VPBUF. 
VTAM will obtain dynamic storage for ‘OPNDST' from the application region. 
This error is normally indicated to the application by a ‘Short on storage 
error return code'. | 


If a link failure occurs on a dial-in SDLC link, VTAM varies the Link tnac- 
tive. The link remains inactive until the network operator varies 1t active 
again. 


On BSC dial-in ports, if the application rejects the logon, VTAM will imme- 
diately disconnect. This could be caused by not having the terminal name 
in the application's list, the application not accepting logons, etc. 
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Problem Isolation Steps 


Check NCP definitions and switched 
VBUILD definitions against the sam- 
ples tn the SNA Product Installa- 
tion Guide (6320-6028). 


Start VTAM I/0, BUF, and NCP line 
traces for the NCP, line, physical 
unit, terminal or logical unit, and 
the UTERM/VTERM, as appropriate. 


For BSC or S/S, use VTAM operator 
display commands to verify that the 
line, port, and UTERM/VTERM are 
active. 


For S/S or BSC, use the VTAM opera- 
tor display command to display 
UTERM/VTERM. 


For SDLC links, use the VTAM dis- 
play command to view the status of 
the physical unit. 


For SDLC links, have the remote 
physical unit dial in. IO and buff- 
er trace for the NCP should have 
been started. Line trace should 
also be initiated prior to dialing 
into the NCP. 
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Reference 
Page(s) 


PROBLEM DETERMINATION/ISOLATION PROCEDURES 


Description 


The sample definitions in 6320-6028 are known to work, 
and can be a good starting point. Definitions are pro- 
vided for each operating system and most of the common 
terminal types. 


In order to isolate this type of problem, the command 
and data traffic that occurs must be seen. 


If the line or port are not active, the port will not 
answer. If the UTERM/VTERM is not active, the port 
will answer, and immediately disconnect. 


If the display for the UTERM/VTERM has 
SIMLOGON=application name, and the application is not 
active, or active and not accepting logons, VTAM will 
immediately disconnect. This also happens if there is 
no SIMLOGON indicated. The SIMLOGON is created by hav- 
ing LOGAPPL=application-name specified for the 
UTERM/VTERM, or by the network operator varying the 
UTERM/VTERM active with the LOGON option. 


The physical unit must be active. 


An operator message will be generated if the Station 
ID (XID) of the physical unit dialing into the NCP does 
not match an XID value implied in any PU macro of a 
VBUILD major node. This message contains the actual 
XID of the physical unit dialing in. VTAM immediately 
disconnects in this case. 
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Problem Isolation Steps (Reference Description 


(continued from last page) | Page(s) 


For SDLC links, if no message is If the VBUILD major node is not active, VTAM will dis- 
generated, and VTAM disconnects the connect. 

link, use the VTAM display command 

to check that the VBUILD major node 

is active. 


Print the traces 4-134 For SDLC links, examine the line trace to see if the 
4-133 physical unit dialing into the NCP transmitted anything 
in response to the SDLC Exchange ID command. If noth- 
ing was received, the problem is at the remote end. 
Check the physical unit and MODEM for NRZI incompat- 
ibility. If the line trace shows the NCP never sent an 
Exchange ID SDLC command, you can suspect a problem in 
the NCP. Check for a local MODEM problem or an NCP 
specification problem. 


Check the sample flow in the SNA 6-1 
device control and flow section of 
this manual. 


Documentation required for IBM | Special Instructions 


Look at the NPDA and/or 370X LOGREC 4-89 Look for MDR records for the line. 
_MDR records. 


VTAM I/O, BUF, and NCP line trace Check against sample flow. 


Copy of VTAMLST/B.book 


3.19 : LINE/LINK DEGRADATION 


SYMPTOM: 


MODEM strapping 


Line quality 


Remote unit strapping or generation 
specifications 


NRZI specification errors 


NCP generation not specified cor- 
rectly 


Recovery parameters miscalculated 


NCP line capacity exceeded 


Physical units defined as 
ISTATUS=ACTIVE on SDLC multipoint 
links are not physically on the 
link, or are powered off. 


6G624-1514-1 


PROBLEM DETERMINATION/ISOLATION PROCEDURES 


Line/link not operating at the speed it 
should be. 


Clear-to-send (CTS) delay, transmit-DB level, and equalization setting all 
can affect line performance. 


Noise levels on the line can cause excessive retransmissions. 


The control program generation options for the remote physical unit may not 
be specified correctly for the communication facilities being used (e.g. 
SYSIMOD parameters for an IBM 3790 Communication System). 


NRZI encoding may» or may not be required for the MODEMs being used. 


The duplex parameter on the line macro should represent the type of commu- 
nication facilities being used or unnecessary delay may be introduced. 


The REPLYTO or RETRIES parameter coded for the line may be higher than nec- 
essary. The RETRIES parameter specified too high can result in degradation 
on multipoint Lines. 


If the 370X's communication scanners’ total line speed limit is exceeded, 
severe degradation can occur due to link overruns. 


This will cause unnecessary link degradation on multipoint links. For 
SDLC physical units, an SNA 'CONTACT' command is perpetually active. The 
degradation caused depends on the REPLYTO value coded for the line and the 
number of physical units powered off or not physically connected. 
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LINE/LINK DEGRADATION 


(continued) 


Low priority In this case the session has no time cares (by design). 


Using two-wire half-duplex MODEM Two-wire half-duplex facilities should not be used on an SDLC link using 

facilities multipoint protocol. The turnaround times required by NCP and the MODEMs 
will degrade performance. NCP may be required to retransmit PIUs because 
the receiving PU may not have completely turned around and missed the NCP's 
SDLC flag character. 


Problem Isolation Steps 


If NPA is installed check NCP and 
link utilization. 


If NPDA is installed check the his- 
tory of the resources. 


Determine the priority of the ses- 
sion. 


Review MDR records (NPDA OR LOGREC) 


Issue a VTAM display command with 
the EVERY option, for the degraded 
links. 


Run the NCP Jline trace for the 
degraded line for a short period of 
time. 
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Reference 
Page(s ) 


G-114 


PROBLEM DETERMINATION/ISOLATION PROCEDURES 


Description 


If the NCP utilization is too high 


Or the links/lines have high number of characters tran- 
smitted or negative pollings. 


Look for temporary errors in the congested component. 


Analyze this VR/ER. Several sessions could be affected 
in the performance, and could be using the same Virtual 
Route and or Explicit Route 


MDR records will indicate the SIO count, soft error 
counts and hard error counts. MDR records should be 
regularly monitored to resolve degradation problems and 
to monitor line quality. 


Check for any physical units which have CONTACTs pend- 
ing. These are physical units which have a status of 
ACT/C or INA/C, if the initial CONTACT failed. Use the 
VTAM vary command to deactivate these physical units. 


Analyze the line trace to see where degradation is 
being introduced. The time field in the NCP line trace 
entries can be used for this. 
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Documentation required for IBM | Special Instructions 


NCP line trace Run TG trace, specially in case of several links per 
TS. 


Copy of VTAMLST/B.book 


LOGREC MDR summary 4-89 


3.26 : PHYSICAL UNIT WILL NOT ACTIVATE 


SYMPTOM: 


Insufficient buffers available 


Physical unit powered of f 


Physical unit SDLC 
incorrect 


address is 
Line between the PU and the 370X is 


incomplete 


Bad NCP generation 


NRZI mismatch 


IBM 3790 SSCP ID mismatch 


6624-1514-f 
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The 'nodename NOW ACTIVE' message is not 
received after a '‘V NET,ACT' command is 
issued for a physical unit. 


VTAM will not activate a physical unit if there are insufficient buffers 
available. This possibility can be checked by having GTF running with the 
VTAM SHS buffer trace on. The ‘NON ACTIVE' message will not be received; 
until all logical units on the PU with ISTATUS=ACTIVE coded, are activated. 


The path te the physical unit will be inoperative, if the physical unit is 
powered off or the path is open. For example, if the remote MODEM is pox- 
ered off or inoperative. 


Check that the address coded in the PU macro matches the address of the 
physical unit. 


Check that the cable from the 370X is connected to the MODEM and the MODEM 
1S powered on. Also check the connections at the physical unit side. 


The 370X interface does not match the NCP definition. Examples of this are 
the use of a 1H interface (two NCP line addresses) and a 1D (one Line 
address} is required, or a discrepancy between the line speed generated in 
the NCP and the actual external clocking speed in the MODEM. 


The NRZI parameter in the line macro of the NCP must be coded to conform to 
the encoding scheme the physical unit will use. 


If the SYSHOST option of the IBM 3790 is specified for a specific SSCP ID, 
and that SSCP ID is not in the SNA ACTPU command, the physical unit will 
not activate. 
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PHYSICAL UNIT WILL NOT ACTIVATE 


(continued ) 

MODEMS incompatible If the two MODEMs are not compatible, data transfer over the link is impos- 
sible. Some common problems are: dissimilar MODEMs, and line speed incom- 
patibility. 

Physical unit not initialized for Some physical units require their host interface be enabled by the operator 

hest contact at the physical unit. For example, on the IBM 37960, the SYSHOST function 


must be performed. 


Physical unit owned by another SSCP If a physical unit is owned by another host (SSCP), the 'CONTACT' will fail 
immediately. This will be tndicated by message IST604I ‘UNABLE TO CONTACT'. 


Problem Isolation Steps Reference Description 


Page(s) 
Issue the VTAM display command with 5-7 A status of ACT/C or INA/C, indicates the NCP is poll- 
the every option, to the physical ing the physical unit but is not getting a response. 
unit. If the status of the PU is INACT, it indicates the PU 


has rejected the activation. If the status is active, 
but the operator message indicating the PU is active 
has not been received, the problem 1s that one of the 
logical units specified as ISTATUS=ACTIVE has not acti- 
vated. Refer to the LU-WON'T-ACTIVATE PD/IP. 


Run MODEM test, if available 4-147 This will determine whether a path between the MODEMs 
exists. 
Run RNIO TRACE if message IST604GI 4-114 The trace should indicate the reason code for the 'CON- 


TACT' failure. 


Run link level tests using TOLTEP. 4-142 This allows you to change the NRZI value by trying the 
test both ways. This test also does an SDLC general 
poll which causes the physical unit to send back its 
SDLC address. 


Perform a communications wraptest Most remote physical units have a wrap test available. 


on the physical unit if one is This should be run to isolate remote problems. 
available 


Documentation required for IBM Special Instructions 


VTAM I/0 trace for the physical Check to see if the SNA 'ACTPU' command was sent to the 
unit and logical units. physical unit. 
NCP line trace Check that an SDLC 'SNRM' command is transmitted and an 


'NSA' response is received. 
Dump of VTAM partition/region Check for buffer pool depletion. 


Dump of CSA (MVS) 


Copy of VTAMLST/B.book 
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3.21 : PHYSICAL UNIT WILL NOT DEACTIVATE 


Logical unit still in session 


Inadequate VTAM buffers 


SYMPTOM: 


A Physical unit will not deactivate when 
a 'V NET,INACT' command has been issued, 
or when NCP or VTAM is being terminated. 


If a logical unit is still in session with an application, the physical 
unit will not deactivate. See the LU-WILL-NOT-DEACTIVATE PD/IP. 


If VTAM does not have sufficient buffers, the physical unit will not deac- 
tivate. IF ACF/VTAM on DOS/VSE, the VPBUF pool may be depleted. 


3-52 


Documentation required for IBM 


6G624-1514-1 


Problem Isolation Steps 


Reference 


Description 


Page(s } 


Verify that all of the LUs associ- 
ated with the PU are inactive by 
issuing a VTAM display command with 
the every option, for the PU (D 
NET,ID=puname,E). 


If all of the logical units' status 
display as INACT or a logical unit 
has a status of ACT/U, issue a VTAM 
vary inactive command with the 
force (F} modifier for the physical 
unit: V NET,ID=puname,INACT,F. 


If the problem is reproducible, 
start a VTAM I/O trace for the PU 6-1 
and the NCP. Also start VTAM's SMS 

buffer pool trace. 


If ACF/VTAM, display buffer use. 


Ref. Page 


VTAM I/70 and SNS buffer = traces 
gathered 


Console log 


PROBLEM DETERMINATION/ISOLATION PROCEDURES 


A PU cannot be deactivated if any of the associated LUs 
are still in session. If any LU shows up as other than 
INACT, see the UNASLE-TO-DEACTIVATE-LU PD/IP. 


This should cause the physical unit to deactivate. 
This is not a normal situation. For 3600 subsystems, 
the subsystem control operator should IPL with the warm 
option before the system operator reactivates the phys- 
ical unit. This will retain the error log in the 
3601/3602 controller. 


This trace will indicate how far into the deactivation 
sequence the physical unit has gotten. 


Check that dynamic buffering is being used. Examine 
VPBUF(DOS/VSE) and see if all pages are being used. 


Special Instructions 
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3.22 : PHYSICAL UNIT FAILS 


SYMPTOM: 


A physical unit is activated, but fails 
during normal operation. 


Link quality or link failure If the path to the physical unit is disrupted, the NCP will timeout. These 

types of problems should be tracked via NPDA or via LOGREC MDR records. If 
the information or MDR records indicate frequent timeouts, the values coded 
on the LINE macro for REPLYTO or RETRIES may not be adequate for the quali- 
ty of the path. If MDR records indicate a request online (ROL) SDLC com- 
mand was received, this means the physical unit has gone through a reset 
sequence, due probably to a timeout. Refer to the device dependencies sec- 
tion in this manual for your particular physical unit. 


Operator Error If the physical unit has been powered off or reset, this type of error will 
occur. VTAM writes the message indicating the physical unit has failed 
after the NCP has finished all its retries and sent VTAM the MDR record 
which indicates the cause of the failure. Review the MDR record. 


Problem Isolation Steps Reference 


Description 


Page(s) 


Review NPDA or LOGREC MDR records. 4-89 MDR records should indicate the type of failure being 
experienced. If the MDR records show a timeout, this 
could be due to the remote physical unit being powered 
off or reset. It could also be due to a path error, 
MODEM failure, etc. Check that the REPLYTO and RETRIES 
operands on the LINE macro are adequate for the line 
quality. Consult the device dependencies section of 
this manual for advice in choosing these values. 


Observe the operation of the Indicators on the MODEMs may indicate loss of carrier, 

MODEMs. loss of synchronization, etc. Refer to the user’s 
guide provided with the MODEM for indicators and test- 
ing procedures available. 

If this problem persists, or the 4-147 If the MODEM wrap tests are successful but the physical 

status of the physical unit remains unit still will not activate, check the operation of 

ACT/C after VTAM indicates recovery the physical unit. 

in progress, run the MODEM wrap 

tests. 


Documentation required for IBM 


Special Instructions 


Operator console log 
LOGREC MDR records 4-89 


Copy of VTAMLST/B.book 
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3.23 : LOGICAL UNIT WILL NOT ACTIVATE 


SYMPTOM: 
A logical unit will not come active, 
either at network startup time, (if 
ISTATUS=ACTIVE is coded for the logical 
unit), or when a 'V NET,ACT' command is 
issued for the logical unit. 
Inadequate VTAM buffers If there are insufficient VTAM buffers, VTAM will not activate the logical 
, unit. The VTAM System Programmers Reference Guide for the applicable system 
should be referenced. 

‘LU hung (non-operational ) On 3600 Finance Communication Subsystems, if the 3600 Control Program does 
not have enough HOST buffers defined for the number of logical units on the 
physical unit, the logical unit may not activate. 

Logical unit not defined in the If the logical unit is not defined or activated at the physical unit level, 

physical unit. , ) the SNA 'ACTLU' command will fail. VTAM issues a message to the network 


operator indicating the resource is unavailable. 


Physical unit not active In order for a logical unit to activate, the physical unit must be active. 


Problem Isolation Steps 


Reference 


Description 


Issue a VTAM display command with 
the every option, on the physical 
unit: D NET,ID=puname,E. 


If the physical unit's status is 
ACT, examine the status of the log- 
ical units in question to see if 
they are active. 


If the problem can be reproduced, 
run a VTAM SMS buffer pool trace 
along with a VTAM I/0 and buffer 
trace for the NCP, physical unit, 
and logical unit affected. 


If the traces indicate the problem 


is between the NCP and the physical 
unit, and the problem has not been 
isolated to the physical unit, an 
NCP line trace may be necessary. 


GG24-1514-1 


Page(s } 


4-114 
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If the PUs status is INA/C, the physical unit is not 
active, and no logical units will activate. See the 
UNABLE~-TO-ACTIVATE-PHYSICAL-UNIT PD/IP. 


If the logical unit is inactive, check that 
ISTATUS=ACTIVE was coded for the logical unit on the LU 
macro, or that the logical unit was varied active. If 
the PU macro has ISTATUS=INACTIVE coded, and the LU 
macros are not coded with ISTATUS=ACTIVE, varying the 
physical unit active will not activate the logical 
units. 


If the LU status is ACT/A;, the physical unit has not 
responded to the SNA ‘ACTLU' command. 


A logical unit status of ACT/B indicates the logical 
unit has not responded to the SNA 'BIND' command. See 
the PD/IP for logical unit logon problems. 


The SMS buffer trace will indicate if the problem is 
due to VTAM buffer depletion. The other traces will 
indicate hon far the activation sequence has completed. 
Refer to the SNA data flow section of this manual. 


The line trace will show whether the SNA ACTLU command 
is being sent (by the NCP), or that the physical unit 
is failing to respond to it. 
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Documentation required for IBM Special Instructions 


Console log 
Copy of VTAMLST/B.book 


Traces gathered 


3.24 : LOGICAL UNIT WILL NOT DEACTIVATE 


SYMPTOM: 
A logical unit is ‘hung’ when it will 
not show inactive, after a 'V NET,INACT' 
command 1s issued. 


Inadequate VTAM buffers If VTAM does not have sufficient buffers, the logical unit will not deacti- 
vate. 


Logical unit in session If a logical unit is in session with an application program, the logical 
unit will not deactivate, regardless of the VTAM vary inactive modifier 
used, until the application issues a 'CLSDST'. If the application does not 
have a LOSTERM exit routine, the session must be terminated by an applica- 
tion operator command, or by terminating the application program. Refer to 
the VTAM operator commands section of this manual to see what each of the 
VTAM vary command modifiers does. 


LU Inoperable If the logical unit does not respond to the SNA CLEAR/UNBIND sequence gen- 
erated by the CLSDST macro, the logical unit will not deactivate. A vary 


inactive for the logical unit with the force modifier will clear this con- 
dition. 


On SDLC 3270s, if the logical unit is powered off while still in session, 
the physical unit may not respond to the SNA CLEAR/UNBIND sequence correct- 
ly. This will prevent the logical unit from deactivating. A hardware 
engineering change (EC747014) to the 3271 control unit corrects this prob- 


lem. The IBM Customer Engineer should be contacted if this problem is 
detected. 


Vary processor hung VTAM's vary processor is serial. If a vary inactive has not completed for 
a previous logical unit on the same physical unit, all subsequent logical 
units will not deactivate until the previous process has completed. 


Application program limits number The application program may be limited by storage availability or design in 

of ‘CLSOSTs' the number of concurrent ‘'CLSDSTs' it can issue. If the application pro- 
gram is watting for responses to the SNA 'CLEAR/UNBIND' sequences generated 
by previous 'CLSDSTs', it will be unable to issue any more 'CLSDST' macros. 
CICS/VS limits concurrent 'OPNDST' and 'CLSDST' operations to ten. 
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[Reference 
Page(s} 


Description 


Issue the VTAM display command for 


the logical unit 


Issue the VTAM vary inactive com- 
mand with the I modifier and then 
display the logical unit. 


If the status of the logical unit 
is ACT/U, issue a vary inact com- 
mand with the force (F) modifier. 


If the problem can be reproduced; 
start a VTAM SMS buffer pool trace 
and a VTAM I/O trace for the phys- 
ical unit and logical unit. If the 
application has internal traces, 
run them if appropriate. 


| Documentation required for IBM 


5-8 


5-27 


If the status of the logical unit is ACT, and it is 
allocated to an application, the application has not 
issued 'CLSDST’. 


This will drive the application's LOSTERM exit routine. 
If the logical unit's status still shows as ACT, the 
application is not issuing 'CLSDST', and the applica- 
tion program's LOSTERM exit (or absence thereof), 
should be investigated. 


This should cause both the 'CLSDST' to complete and the 
logical unit to deactivate. This condition can be 
caused by the logical unit not responding to the SNA 
CLEAR/UNBIND sequence generated by the 'CLSDST'. The 
hardware EC/REA level, and the software of the subsys- 
tem should be investigated. 


The SMS buffer pool trace will indicate a VTAM buffer 
pool depletion problem. The I/O trace will show how 
far into the deactivation sequence the operation has 
been able to get. An application trace is useful to 
determine if the application's LOSTERM exit has been 
driven and the application has issued 'CLSDST'. 


Special Instructions 


Console log 
Traces gathered 


Copy of VTAMLST/B.book 
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3.25 : LOGICAL UNIT LOGON PROBLEMS 


SYMPTOM: 
A terminal or logical unit cannot logon; 
or be varied on, to an application pro- 
gram. 


ee eas | ee 
Sessions : te teenmene Links 
Se eercees | as 


+ Priorities 


May be a convenient measure to have prepared several sessions with combina- 


tions of: 


- Transmission groups 


Explicit routes 


Virtual routes 


- Transmission priorities 


When one problem appears it is easier to isolate it by seeing the sessions 


affected. 
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LOGICAL UNIT LOGON PROBLEMS 


(continued) 


Incorrect session parameters A session is established by the application program tssuing an "OPNDST' 
macro. This results in an SNA ‘BIND' command being sent to the logical 
unit. The BIND command contains parameters which define the protocols to 
be used during the session. The logical unit may reject the bind if the 
session parameters are incompatible with its design or logical operation. 


The parameters for the SNA BIND command are obtained from an entry in a 
LOGMODE table, or from an application built BINDAREA. If there is no BIN- 
DAREA specified in the NIB, the LOGMODE table used 1s the one coded in the 
LU macro or the IBM-supplied default table ISTINCLM. 


The entry to be used in the LOGMODE table is coded in the NIB macro. Ifa 
LOGMODE entry is not coded in the NIB, the LOGMODE entry specified on the 
SNA 'INITIATE-SELF' command (LOGON, for a Type 1 PU), or the first entry in 
the default LOGMODE table is used. 


Check the COS table if the VR and priorities are suited to real configura- 
tion. 


Inadequate VTAM buffers If VTAM does not have sufficient buffers, the logon may be queued until 
buffers become available. 


Application rejection If the application does not support the terminal type or the specific log- 
ical unit name, it may reject the INITIATE SELF/LOGON. For a Type 1 phys- 
tcal unit, VTAM will send the logical unit a ‘SESSION NOT BOUND' message. 
For a Type 2 physical unit, VTAM will send a negative response to the SNA 
INITIATE-SELF command (0621 SNA sense). 


Application not accepting logons If the application is not accepting logons, the logon request may be queued 
| with no response. 


Application's region/partition too VTAM requires storage to be available in the user partition/region in order 
small eo ae to process the ‘OPNDST' macro. 


Problem Isolation Steps Reference Description 


Page(s) 
See if problem is with one or If several LUs but same VR/ER, the problem can be with 
several logical units. the ER. 
Issue the VTAM display command for 5-8 Check to see if the logical unit is active and allo- 
the logical unit. cated to an application. 
Issue the VTAM display command for 5-3 Check to see if the application has any session 
the application. requests outstanding. A session request indicates the 


application has logon requests queued. 


Issue the VTAM vary command with VTAM treats this as a priority request. If this works, 
the LOGON option to log the logical a VTAM buffer pool is probably at threshold. 

unit onto the application. 

Run a VTAM SMS buffer pool trace 4-114 If the trace shows a negative response to an SNA INITI- 
and a VTAM I/O and buffer trace for 6-1 ATE-SELF command was received, the sense data included 
the logical unit. should indicate why. 


If a positive response is received to an INITIATE-SELF 
followed by an SNA 'PROCEDURE ERROR' command, the 
application rejected the logon. For a Type 1 physical 
unit, this is indicated by a ‘SESSION NOT BOUND’ mes- 
sage being sent to the terminal. Check the 
sessjion-limit specified in the SESSION operand of the 
NCP LINE macro. 


If a positive response is received, but is not followed 
by an SNA ‘PROCEDURE ERROR' command, the application is 
queuing logons or is short on storage. 


If the traces indicate that an SNA ‘BIND' command was 
issued and rejected by the logical unit, check the 
sense data included with the negative response. If the 
sense indicates invalid session parameters, check LOG- 
MODE specifications. Some applications such as JES, 
CICS/VS, and IMS/VS create their own BIND images and 
they may differ from the LOGHMODE specifications. I/0 
and buffer traces may be the only way to determine the 
session parameters that the application is using. 
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Documentation required for IBM Special Instructions 


VTAMLST, Paths table, COS table 


Traces gathered 


3.26 : LOGICAL UNIT HANGS 


SYMPTOM: 


A logical unit does not respond to any 
message traffic or commands. 


Path failure If a path failure has occurred on an SDLC link, VTAM drives the applica- 
tion's LOSTERM exit for all active sessions on the link. The sessions will 
be terminated if the application issues 'CLSDST'. 


Inadequate VTAM buffers If VTAM has insufficient buffers available, the application may not be able 
to issue SEND or RECEIVE macros. CRPLBUF,IOBUF and PPBUF buffer pool 
depletion can cause this problem. 


Incorrect session parameters The BIND parameters may be acceptable to the logical unit, but not applica- 
ble to the session being conducted. For example, if the BIND parameters 
specify an interactive session is to be used, but a batch session is~ 
attempted, the logical unit may hang. 


Terminal operator error The terminal operator may have put the logical unit in a system state where 
it cannot communicate with the Primary Logical Unit, the application. For 
example, the operator pressing the System Request Key on an IBM 3767. 


Application program error If the application program fails to issue a SEND or RECEIVE macro for the 
logical unit, the logical unit will hang. Also, if the application program 
fails to follow the protocols established for the session on the BIND com- 
mand, the logical unit may hang. Session parameters are neither validated 
nor enforced by VTAM or NCP. Conforming to these protocols is the sole 
responsibility of the logical units involved in the session. 
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LOGICAL UNIT HANGS 


(continued) 


Subsystem buffers inadequate On the 3600 subsystem, if insufficient host input buffers are specified, 


inactive work stations can cause other work stations to hang. Normally a 
receive buffer should be provided for each active logical unit. 


Logical unit not in session Not all devices indicate the session has been terminated by the 


application. The session may have been terminated by the application pro- 
gram because of an error. Some common causes are: 


An input message from the logical unit longer than the maximum set by the 
system programmer for that unit. 


This can also happen if the application sends an output message longer than 
the maximum specified by the system programmer. 


BUFFACT and BUFLIM settings should also be checked. 


BSC 3270 cluster fails For BSC 3270 terminals, if there is a general poll failure for the cluster 
(mainly timeout, but also hardware failure, sometimes the Test Request 
key), the terminal will be hung until the network operator varies the clus- 
ter tnactive with the immediate option and then, after VTAM indicates that 
the cluster is inactive, varies the cluster active. A general poll failure 
will create an MDR record. 


BSC 3270 Test Request If a remote 3270 terminal operator hits the Test Request Key, and there is 
data on the screen that can be interpreted as a TOLTEP request, the cluster 
may be hung waiting to logon to TOLTEP. A zap to the NCP is available to. 
have the NCP ignore the Test Request key. Instead of using the Test Request 
key, TOLTEP can be logged on to by adding capability to the USSTAB provided 
for the LU or the Interpret Table for terminals. 
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Problem Isolation Steps 


Issue the VTAM display command with 
the every option, for the physical 
unit. 


Issue the VTAM display command for 
the logical unit. 


Start VTAM I/O and buffer traces 
for the physical unit and logical 
unit. Also start VTAM's SMS buffer 
pool trace. Attempt to enter data 
from the logical unit. 


If the trace indicates that data is 
not being received by the NCP, or 
that data is not being sent from 
the NCP to the logical unit, an NCP 
line trace should be started on the 
line. 


If the problem is on the 3600 Sub- 
system, display/print the statis- 
tical counters. 


| Documentation required for IBM 


Reference 
Page(s ) 


4-114 


Description 


Check to see if both the physical unit and logical unit 
are active. 


Check to see if the logical unit is active and in ses- 
sion with an application program. 


If there is an inbound RNIO entry and TPIOS buffer 
entry for the data you entered, then you Know that VTAM 
is getting the data. If there is an inbound Control 
Layer (C/L) buffer entry, the data has been received by 
the application. An outbound C/L buffer entry in 
response to the data, indicates that the application 
program has issued a SEND. TPIOS and RNIO outbound 
entries will show that the data has been sent to the 
NCP. Interpreting this flow should indicate the fail- 
ing component. 


The line trace will indicate 1f the messages are being 


sent in from the logical unit to the NCP or being sent 
from the NCP to the terminal. 


The 3600 counters three and twelve will indicate if the 
3600 has sending or receiving problems. 


Special Instructions 


Traces gathered 
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HUNG LU TRACING EXAMPLE 


This sequence shows a typical 'HUNG LU' situation and the isolation procedures used. The problem shows 
up as the inability to shut down VTAM because the UNBIND is not completing for an LU. The situation can 


be reproduced by varying the LU inactive. The network operator first displays the status of the terminal 
to verify it is in session and traces have been activated. 


d net,1d=1lu3270v2 

11.25.56 STC 329 ISTO97I DISPLAY ACCEPTED 

11.25.57 STC 329 IEE932I 408 

ISTO75I VTAM DISPLAY- NODE TYPE= TERM ,NAME= LU3270V2 ,STATUS= ACT 
ISTOS8II CLINE NAME= SOLC13C , LINE GROUP= SDLCGV1 , 370X= NCPCH2 
IST135I PHYSICAL UNIT= PUS270V , 

ISTO82I DEVICE TYPE= LUOL , ALLOC TO= TSO0C01 ,SIMLOGON= 
IST654I I/O TRACE= ON ,BUFFER TRACE= ON 


In order to validate the flow between the LU and NCP, a line trace is now started. 


f net, trace, type=line,id=sdlicl3c 
11.26.22 STC 329 ISTO97I MODIFY ACCEPTED 
11.26.23 STC 329 IST513I TRACE INITIATED FOR NODE SDLC13C 


The Logical Unit is now varied inactive with the ‘I' modifier and a display is performed in order to 


verify that the status is ‘ACT/U' as expected. At this point, the traces should show the complete flow, 
so the line trace is turned off immediately to minimize the amount of trace data. 


vy net,inact,1,1d=lu3270v2 
11.26.41 STC 329 ISTOS7I VARY ACCEPTED 


d net, 1d=1u3270v2 

11.26.57 STC 329 ISTO097I DISPLAY ACCEPTED 

11.26.57 STC 329 IEE932TI 416 

ISTO75I VTAM DISPLAY- NODE TYPE= TERM ;,NAME= LU3270V2 ,STATUS= ACT/U 
ISTO81I LINE NAME= SDLC13C , LINE GROUP= SDLCGV1 , 370X= NCPCH2 
IST135I PHYSICAL UNIT= PUS3270V , 

ISTO082I DEVICE TYPE= LUO] , ALLOC TO= TSO0001 ,SIMLOGON= 

IST654I I/0 TRACE= ON ,BUFFER TRACE= ON 


Ff net;,notrace,type=line,id=sdlcl3c 


11.27.17 STC 329 ISTO97I MODIFY ACCEPTED 
11.27.18 STC 329 IST512I TRACE TERMINATED FOR NODE= SDLC13¢C 


These trace entries are a result of the vary command. It can be determined that a CLEAR request was sent 
out by VTAM through the NCP to the LU (in this case a 3277 attached to a 3271-12). A negative response is 
returned, which according to SNA protocol is treated the same as a positive response on a CLEAR request. 
But an apparent error has been made because the sequence number for the response is different than the 
number of the request. This causes VTAM to disregard the response and wait for one with the proper 
sequence number. NCP generated the incorrect sequence number because it received a PIU from the 3271 
that indicated in the TH that it was ‘NORMAL FLOW' instead of ‘EXPEDITED FLOW' (NCP uses this bit for 
3276 support to determine whether to assign the sequence number for the SSCP-LU session or the LU-LU 
session). The 3271 would give this erroneous response when it received a CLEAR to a 3277 that was 
powered off. An engineering change (EC747014) to the 3271 controller was required to fix this problem. 


USRFD FEF ASCB O0FE3918 JOBN YGLO 


TPIOS CUT ANODE TSO0001 FOB 00000000 00B81A20 OO0E000N0 RSVD 0000 LNGe 0O0CO RSVD 90000000 00000000 
REMOTE DNODE LU3270V2 THRH 10002849 08010000 O0006B80 00 


TEXT Al 
TIME 41202.396266 
RNIO ASCB OOFE3918 CPU 0000 JOBN YGLO OUT 1F002849 08010002 00046B80 OO0Al 
TIME 41202.487020 
RNIO ASCB OOFE3918 CPU 0000 JOBN YGLO IN 1E000801 28490006 00078F90 00000000 10 


TIME 41202.663579 
USRFD FEF ASCB OOFE3918 JOBN YGLO 
TPIOS IN ANODE TSOO00O1 FOB 00000000 OOB814D1 00040000 RSVD 0830 LNG2 OODC 
REMOTE ODONODE LU3270V2 FSB 022C0000 00000000 08012849 00060000 00000000 00000000 00000000 00070000 
. THRH 1E000801 28490006 00078F90 00 


TEXT 00000010 Meco 
TIME 41202 .687004 
USRFD FF2 ASCB OOFEDI58 JOBN NET 
LINE = DNODE NCPCH2 EP 00 TIME D7 
LCD 9 PCF 7 TIME Ce SCF GA PDF 11 LCD 9 PCF 7 TIME C2 SCF 4A PDF 50D 
LCD 9 PCF 7 TIME C2 SCF GA PDF BA LCD 9 PCF 6 TIME C2 SCF OE PDF BA 
LCD 9 PCF 6 TIME C3 SCF OE PDF BA LCD 9 PCF 7 TIME C3 SCF 4A PDF C5 
LCD 9 PCF 7 TIME C3 SCF GA PDF 2E LCD 9 PCF 7 TIME C3 SCF 4A PDF 3E 
LCD 9 PCF 7 TIME C3 SCF 4A PDF C2 LCD 9 PCF 7 TINE C3 SCF 4A PDF 8&F 
LCD 9 PCF 7 TIME C3 SCF GA PDF 90 LCD 9 PCF 7 TIME C3 SCF 4A PDF 00 
LCD 9 PCF 7 TIME C3 SCF GA PDF 00 LCD 9 PCF 7 TIME C3 SCF 4A PDF OO 
LCD 9 PCF 7 TIME C3 SCF GA PDF 00 LCD 9 PCF 7 TIME C3 SCF 4A PDF 10 
LCD 9 PCF 7 TIME C3 SCF GA PDF 3€ LCD 9 PCF 7 TIME C3 SCF 4A PDF C8& 
LCD 9 PCF 6 TIME C3 SCF OE PDF C8 LCD 9 PCF 7 TIME C3 SCF 4A PDF C5 
LCD 9 PCF 7 TIME C3 SCF 4A PDF 35 LCD 9 PCF 7 TIME C3 SCF GA PDF 7B 
TIME 41204. 736221 
USRFD FF2 ASCB OOFEDI58 JOBN NET 
LINE DNODE NCPCH2 EP 00 TIME D7 
LCD 9 PCF A TIME C2 SCF 40 PDF Fil LCD 9 PCF A TIME C2 SCF 40 PDF 53 
icD 9 PCF 9 TIME C2 SCF 40 PDF 5D LCD 9 PCF 9 TIME C2 SCF 45 PDF 7E 
LCD 9 PCF 9 TIME C2 SCF 45 PDF 7E LCD 9 PCF 9 TIME C2 SCF 40 PDF C5 
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LCD 9 PCF 9 TIME C2 SCF 40 PDF EO LCD 9 PCF 9 TIME C2 SCF 40 PDF 3F 
LCD 9 PCF 9 TIME C2 SCF 40 PDF C2 LCD 9 PCF 9 TIME C2 SCF 40 PDF 68 
LCD 9 PCF 9 TIME C2 SCF 40 PDF 80 LCD 9 PCF 9 TIME C2 SCF 40 PDF 00 
LCD 9 PCF 9 TIME C2 SCF 40 POF Al LCD 9 PCF 9 TIME C2 SCF 40 PDF Al 
LCD 9 PCF 9 TIME C2 SCF 40 PDF DE LCD 9 PCF 9 TIME C2 SCF 45 PDF 7E 
LCD 9 PCF 9 TIME C3 SCF 45 PDF 7E LCD 9 PCF 9 TIME C3 SCF 460 PDF C5 
LCD 9 PCF A TIME C3 SCF 40 PDF Fl LCD 9 PCF A TIME C3 SCF 40 PDF 53 
LCD 9 PCF 9 TIME C3 SCF 40 PDF 5D LCD 9 PCF 9 TIME C3 SCF 45 PDF 7E 


TIME 41204.891504 


The operator now issues the vary inactive command, but this time with the 'F' modifier, which will 


inactivate the LU without any I/O operations. This command breaks both LU-LU session and SSCP-LU session. 


v net,inact, f,i1d=1u3270v2 

11.27.35 STC 329 ISTO97I VARY ACCEPTED 

11.27.35 STC 329 IST619I NETHORK NODE LU3270V2 HAS FAILED - RECOVERY IN PROGRESS 
11.27.36 STC 329 IST141I NODE LU3270V2 NOW DORMANT 

11.27.36 STC 329 IST129I UNRECOVERABLE ERROR ON NODE LU3270V2 - VARY INACT SCHEDULED 
11.27.36 STC 329 ISTI0GI VARY FAILED FOR ID= LU3270V2 ~- NODE ALREADY INACTIVE 
11.27.37 STC 329 IST105I Lu3270V2 NODE NOW INACTIVE 


The trace entries below show the result of the vary inactive with the force modifier. 


USRFD FEF ASCB O0OFE3918 JOBN YGLO 
TPIOS OUT ANODE TSOO0001 FDB 00000000 OOBS803C8 OOOE0N0NN RSVD 6000 LNG2 OO0CO RSVD 00000000 00000000 
REMOTE DNODE LU3270V2 THRH 10002849 08010000 00006B80 00 
TEXT Al *, * 
TIME 41256 .342975 
USRFD FEF ASCB OOFE3918 JOBN YGLO 
TPIOS OUT ANODE TSOOO0O01 FDB 00000000 00880680 O000F0000 RSVD 0000 LNG2 O0OCO RSVD 00000000 00000000 
REMOTE DNODE LU3270V2 THRH 10002849 08010000 00006880 00 


TEXT 3201 *e. * 
TIME 41256.369013 
USRFD FEF ASCB OOFEDI58 JOBN NET 
TPIOS OUT ANODE VTAM FDB 00000000 OOBS802E0 OOOE0000 RSVD 0000 LNG2 00CO RSVD oco00C000 00000000 
REMOTE DNODE LU3270V2 £THRH 10002849 08000000 00006B80 00 
TEXT Al *, * 


TIME 41256 .407693 
USRFD FEF ASCB OOFEDI58 JOBN NET 
TPIOS IN ANODE VTAM FDB 00000000 00B80301 OOOED00D RSVD 0000 LNG2 00CO 
REMOTE DNODE LU3270V2 FSB O22C0000 00000000 08002849 00020000 00000000 00000000 00000000 00040000 
THRH 1F000800 28490002 O004EB80 00 
TEXT ALE5E3C1 D4404000 00000000 0000 NVTAM 2. eee * 


TIME 41256.417069 
ASCB OOFE3918 JOBN YGLO 
TPIOS IN ANODE TSOO0001 


USRFD FEF 


TIME 
ASCB OOFE3918 JOBN YGLO 
TPIOS IN ANODE TSO0001 


USRFD FEF 


TINE 
ASCB OOFED158 JOBN NET 
TPIOS OUT ANODE VTAM 


USRFD FEF 


TIME 
ASCB OOFED158 JOBN NET 
TPIOS IN ANODE VTAM 


USRFD FEF 


FDB 00000000 OOBS03E9 OO0E00D00 RSVD 0000 LNG2 00CO 
REMOTE ODONODE LU3270V2 FSB 022C0000 00000000 08012849 00030000 06000000 00000000 00000000 00040000 
THRH 1F000801 28490003 OO004EB80 00 
TEXT ALE3E2D6 FOFOFO0OG 00000000 0000 *.TSOOOO....... * 
41256 .618492 
FDB 00000000 SOBS806Al O00F0000 RSVD 98000 LNG2 00CO 
REMOTE DNODE LU3270V2 FSB 022C0000 00000000 08012849 00040000 00000000 90000000 00000000 00050000 
THRH 1F000801 28490004 OOO5SEB80 00 
TEXT 3201E3E2 DG6FOFOO0O 00000000 000000 *..TSO00........ * 
41256 .628858 
FDB 00000000 00B80680 O00E0000 RSVD 0000 LNG2 O00CO RSVD 060000000 00000000 
REMOTE DNODE LU3270V2 THRH 10002849 08000000 00006B80 00 
TEXT Al *, ¥ 
41256.818202 
FOB 00000000 O0B806Al O00E0D000 RSVD 0000 LNG2 OO0CO 
REMOTE DNODE LU3270V2 FSB 0622C0000 00000000 08002849 00030000 00000000 00000000 00000000 00040000 
THRH 1F000800 28490003 OO0GEBSO 00 
TEXT ALE5E3C1 D4404000 00000000 0000 RVTAM woe eee * 


TIME 41256.827562 


now be terminated. 


d net, id=lu3270v2 


| The status of the logical unit is displayed again to verify that it is inactive. 


NCP and VTAM can 


11.27.50 STC 329 ISTO97I DISPLAY ACCEPTED 
11.27.50 STC 329 IEE9Z2I 429 
ISTO75I VTAM DISPLAY- NODE TYPE= TERM~ ,NAME= LU3270V2 ,STATUS= INACT 
ISTO81I LINE NAME= SDLC13C , LINE GROUP= SDLCGVI1 , 370X= NCPCH2 
IST135I PHYSICAL UNIT= PU3270V_ , 
ISTO82I DEVICE TYPE= LUO] , ALLOC TO= » SINLOGON= 

I/O TRACE= ON ,BUFFER TRACE= ON 


IST6541I 
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3.27 : LOGICAL UNIT SESSION TERMINATES ABNORMALLY 


SYMPTOM: 


DOS/VSE ACF/VTAM 


Application's partition/region tco 
small 


- Session terminated by application 


NCP speci fications 


Link failure 


Terminal operator error 


A logical unit can establish a session, but fails during normal 
operation. 


On a DOS/VSE ACF/VTAM system if the application does not have a RECEIVE 
macro outstanding, VTAM will place the data received in VPBUF. If VPBUF is 
short on storage, the session will be terminated. The dynamic buffer allo- 
cation feature of ACF/VTAM works only within the VPBUF allocation! 


On OS/VS versions of ACF/VTAM, if the application does not have a RECEIVE 
outstanding, VTAM will place the data received from a logical unit in the 
application's region/partition. If the storage is not available in the 
application's region/partition, VTAM will free the data received, issue an 


SNA ‘CLEAR’ command to the logical unit and drive the application's LOSTERM 
exit routine. 


The application may be terminating the session because of a valid error 
condition. For example, a no-data-entered timeout condition on TSO will 
cause TSO to issue 'CLSDST' and terminate the session. 


If the application sends a message larger than the MAXDATA value coded on 
the NCP PCCU macro, the session will be terminated. If the application 
sends a message to a non-segmenting physical unit, which exceeds the MAXDA- 
TA value coded on the PU macro, the session will be terminated. 


If there is a loss of contact with the physical unit, the logical unit's 
sessions will be terminated. 


For local 3270s, if the terminal operator presses the Test Request Key, 
VTAM drives the application's LOSTERM exit, and a ‘CLSDST' macro will prob- 
ably be issued by the application, terminating the session. 
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LOGICAL UNIT SESSION FAILURES 


(continued) 

IBM 3767 terminal error If the IBM 3767 hardware is not at the correct engineering change level for 
SDLC operation, the session can be suddenly terminated after it has been 
working for a while. This error is indicated to the application by an SNA 
Exception Response to a 'SEND' with sense data of '081B0000'. VTAM traces 
can be used to isolate this problem. 

BUFLIM/BUFFACT exceeded On VTAM Level 2, if the product of BUFLIM (coded on the NCP LU macro), and 


BUFFACT (coded on the application major node defined in VTAMLST/B.book), is 
exceeded for queued input from a logical unit, VTAM will free the buffers 
containing the data, issue an SNA 'CLEAR' command to the logical unit, and 
drive the application's LOSTERM exit. The application may terminate the 
session. This problem does not exist for RECORD mode sessions if using 
ACF/VTAM. 
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Reference 


Description 


Review the network console log for 
a problem indication. 


Review appropriate 
logs. 


application 


Review the appropriate physical 
unit logs. 


If the source of the error ts not 
determined, and it may be repeated, 
start VTAM I/O and buffer traces 
for the physical unit and the log- 
ical unit. The VTAM SMS buffer pool 
trace should also be run. 


Documentation required for IBM 


Page(s) 


If a console message indicates a physical path problem, 
see the link failure PD/IP. Error messages may also be 
sent to the system console by the application, indicat- 
ing the reason for the failure. 


The application may have facilities to record error 
conditions. For example, both CICS/VS and IMNS/VS have 
error recording facilities. 


Most Type 2 physical units record error conditions. 
These logs should be investigated. The IBM Customer 
Engineer should be able to assist the user in obtaining 
and interpreting the contents. 


These traces are necessary to determine exactly what 
occurred. If this problem is intermittent and can 
occur on any logical unit, the VTAM zap to start the 
I/O and buffer traces on all nodes may be needed. 


Special Instructions 


Console log 
Copy of VTAMLST/B.book 


Traces gathered 
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3.28 : LOGICAL UNIT RESPONSE TIME SLOW 


SYMPTOM: 
A logical unit can maintain a session 
with an application program, but the 
message traffic is very slow. 


See also LINE/LINK DEGRADATION 


Inadequate VTAM buffers If VTAM has’ insufficient buffers, the application's SEND and RECEIVE 
requests may be queued by VTAM. CRPL and UECB buffer specifications should 
be checked. 


Application program slow The application may not have enough RECEIVE RPLs for the traffic on the 
system. The application program may be using single-threaded programming, 
have too low a priority, etc. Look for excessive use of PPBUFs in VTAM 
Level 2, and VPBUF in DOS/VSE ACF/VTAM. An examination of the time betneen 
the inbound TPIOS layer and the inbound CLO] may indicate a shortage of 
RECEIVE RPLs for an application. This is the only way a user can determine 
a shortage if the OS version of ACF/VTAM/VS is installed. 


Host system performance or capacity System real storage may not be adequate and heavy paging may be occurring. 

Link errors Recoverable errors at the link level may be causing response time degrada- 
tion. 

NCP specifications NCP specifications at the link level can cause performance problems. Some 


common problems are: line speed too slow for the traffic, BFRS size vs. 
MAXOUT value incorrectly specified, service limit (SERVLIM on the NCP LINE 
macro) set too high, PASSLIM and PACING set too low for the subject LU; 
etc. Refer to the examples in the SNA Product Installation Guide 
(6320-6028). 


Contact pending on shared link On a multipoint link, if PU macros are coded ISTATUS=ACTIVE, and a physical 
unit 15 unavailable, link performance is degraded. 
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Problem Isolation Steps Reference Description 
Page(s) 

NPDA and/or review MDR records in 4-89 Check to see if the link is getting excessive soft 
LOGREC errors. MDR records should be reviewed regularly. 

Run VTAM I/O and buffer traces for 4-114 If the time difference between an RNIO trace entry and 
the physical unit(s) and logical 6-1 its corresponding TPIOS trace entry 1s large, a heavy 
unit(s) experiencing the response system load should be suspected. These entries should 
time problem. In addition, run a occur at almost the same time. On a DOS/VSE VTAM sys- 
VTAM SMS buffer pool trace. GTF tem, missing trace entries indicate a heavily loaded 
must be started with TIME=YES spec- system. VTAM will write a record on the trace file 
ified; options required are USR and when it is forced to drop data but does not indicate 
RNIO... The DOS/VSE trace facility this when it prints the file. 

does not timestamp trace entries. . 

a If the time difference between the TPIOS inbound entry 


and its corresponding Control Layer (C/L) inbound entry 
is large, the application program may not have enough 
concurrent RECEIVE macros active. This problem also 
shows up as PPBUF buffer usage. This can be seen in 
the SMS buffer pool trace entries. 


The time between a C/L inbound entry and the next C/L 
outbound entry to the same logical unit is the applica- 
tions processing time. This may tndicate application 
performance problems. 


The time between a C/L outbound entry and its corre- 
sponding TPIOS outbound entry indicates VTAM's process- 
ing time. If this time difference is large, the VTAM 
buffers may be going into a threshold condition, thus 
causing SENDs to be queued by VTAM. 


The time between an RNIO outbound trace entry and the 
next RNIO inbound trace entry for the same logical unit 
indicates transmission and processing time in the chan- 
nel, NCP, link, physical unit, and logical unit. 


If the problem is outboard of the 4-114 Analyze the line trace to see where degradation is 
NCP, the NCP line trace should be being introduced. The time field in the NCP line trace 
run. entries can be used for this. 


Documentation required for IBM Special Instructions 


Traces gathered 


Copy of VTAMLST/B.book 
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2:29 : BSC WILL NOT ACTIVATE 


SYMPTOM: 


Inadequate VTAM buffers 


ISTATUS specification incorrect 


Line/link problem 


3270 cluster failure 


A Bisyne device cannot be activated. 


If there are insufficient VTAM buffers available, VTAM will not activate 
the terminal. 


Unless ISTATUS=ACTIVE is specified at the terminal and VTERM level, acti- 
vating the line and cluster will not activate the terminal or VTERM/UTERM. 


The UTERM and VTERM are identified by VTAM as separate nodes, and they must 
be active. 


The status of the clusters and terminals on a link may show inactive 
because the link has failed, and is inactive. Refer to the appropriate 
LINE/LINK PD/IP if the link cannot be varied active. 


If the general poll to the cluster fails at initial startup, the terminals 
will not activate. The cluster must be varied = active. Unless 
ISTATUS=ACTIVE was coded on each terminal macro, each terminal will have to 
be varied active. 


3-78 


Problem Isolation Steps Reference 


Page(s) 


Description 


Issue a VTAM display command with 5-5 Verify that all node levels have a status of ACT. If 

the every option for the line. the status of all node levels is ACT, see the BSC 
ACTIVE-BUT-NOT-COMMUNICATING PD/IP. 

If the status of any node in the 5-26 If a node cannot be varied active, see the PD/IP for 

path 1s not ACT, issue a VTAM vary VTAM-COMMANDS -DO-NOT-WORK. 

command to activate it. 

Start VTAM's I/O trace for the NCP 4-114 Check to see that the SNA 'ACTLINK' command was sent to 

and also VTAM'S SMS buffer pool 6-1 the NCP for the line in question, and a positive 

trace. 


response was received. Check that the SMS buffer pool 
trace does not show buffer pool depletion. 


Documentation required for IBM Ref. Page Special Instructions 


Console log 


Copy of VTAMLST/B.book 


Traces gathered 
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3.30: BSC WILL NOT DEACTIVATE 


SYMPTOM: 
A bisyne device will not deactivate. 
Inadequate VTAM buffers If VTAM has insufficient buffers, the deactivation process may not 
complete. 
Terminal is still in session Terminals cannot be deactivated if they are still in session. The appli- 
cation program they are in session with must issue 'CLSDST'. 
NCP error For BSC, VTAM sends the NCP FID 0 (BTU) commands to deactivate the node. If 


the NCP does not respond to the '‘V NET,INACT' command, an NCP problem 
should be suspected. 


Problem Isolation Steps 


Reference 
Page(s) 


Run a VTAM SMS buffer pool trace; 4-114 
and an I/O trace for the NCP, clus- 6-1 
ter, and terminal. 


Issue the VTAM display command to 
display the status of the terminal 
(UTERM/VTERM for dial ports). 


If the terminal (UTERM/VTERM for 5-27 

dial ports) is connected to an 

application, issue the VTAM vary 

command with the immediate (I) mod- 

ifier for the terminal (UTERM/VTERM 

for dial ports). The recovery (R) 

and force (F) modifiers do not work 

on BSC or local 3270 devices. 

Documentation required for IBM Ref. Page 

Traces gathered 

Console log 

NCP dump 4-138 
GG24-1514-1 


PROBLEM DETERMINATION/ISOLATION PROCEDURES 


Description 


Check that the SMS buffer pool trace does not show a 
buffer pool depletion. Also check that the FID 0 
reset/disconnect sequence has been sent to the cluster 
and terminals and 


that positive responses were 
received. The reset/disconnect sequence for the termi- 
nals is generated when the application program issues 


‘CLSDST'. If no sessions are active, the reset and 
disconnect commands are not sent to the terminals. 
Refer to the 370X # £=Program Reference Handbook, 


GY30-3012, Section 3: BTU COMMANDS AND MODIFIERS. 


Determine if the terminal (UTERM/VTERM for dial ports) 
is allocated to an application. 


If the application program has a LOSTERM exit and 
issues 'CLSDST', a reset/disconnect sequence is sent to 
the terminal. If the application does not 
'CLSDST', the terminal will not deactivate. 


issue 


If no response to the reset/disconnect sequence 1s seen 
in the I/0 trace, a dump of the NCP should be taken. 


If a negative response to the reset/disconnect sequence 
is received, sense data should be included. Refer to 
the 370X Program Reference Handbook, GY30-3012, Section 
8: BTU RESPONSES. 


Special Instructions 


Needed only if no response to the reset/disconnect 


sequence was received. 
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3.31 : BSC ACTIVE BUT NOT COMMUNICATING 


SYMPTOM: 
A bisyne device can be activated, but 
cannot get into session and communicate 
with an application program. 
Not logged on to an Application The status of the cluster or terminal will indicate ACT; but the cluster or 
terminal will not be polled until an application issues an ‘OPNDST’ macro. 
NETSOL is considered a VTAM application program and normally S/S and BSC 
terminals are logged onto NETSOL. For dial ports, see the PD/IP for 
line/link dial problems. 
A BSC terminal can be logged on to an application in three ways: 
1} The application issuing an 'OPNDST' macro, with the ACQUIRE 
option for the terminal, or issuing a 'SIMLOGON' macro. 
2) Coding the LOGAPPL parameter on the TERMINAL macro. 
3) The network operator issuing the 'V NET,ACT' command with the LOGON 
option. . 
Inadequate VTAM buffers | If VTAM has insufficient buffers to establish the session, the 'OPNDST' 
will be rejected. | 
Incorrect NCP specifications Incorrect line parameters coded in the NCP for the type of hardware used 
can cause this problem. Common problems are incompatible MODEMs, wrong 
transmission code specified, misuse of the direction (DIRECTN) operand of 
the TERMINAL macro,» etc. 
3270 cluster failure A 3270 cluster failure does not drive the application's LOSTERM exit. The 


cluster must be varied inactive with the immediate option. After VTAM 
indicates the cluster is inactive, the cluster may be varied active. 


Problem Isolation Steps Reference Description 
Page(s} 


Issue the VTAM display command for 5-8 If the terminal is not allocated to an application pro- 
the terminal. gram, no communication 1s possible. Use the VTAM vary 
command to log the terminal onto the application. 
Check your procedure for logging a terminal onto an 


application. 
If the terminal is allocated to an 5-27 This will drive the application's LOSTERM exit, which 
application program, issue the VTAM should issue the 'CLSDST’ macro. 
vary inactive command with the 
immediate modifier, for the cluster 
(or terminal, if the terminal is 
not on a cluster). 
Start VTAM's I/O and buffer traces If the failure recurs, compare the failing sequence 
for the cluster and terminal, and with the sample flow provided in publication 
vary the cluster and = terminal G320-6016(SNA System Problem Determination Guide). 


active. 


Documentation required for IBM Special Instructions 


Traces gathered 
Console log 


Copy of VTAMLST/B.book 
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3.32 : BSC SESSION TERMINATES ABNORMALLY 


& bisync device can be activated and 
establish a session, but the session 
terminates during normal operation. 


Inadequate VTAM buffers If VTAM buffers are at threshold, the application program's SEND and 


RECEIVE macros will be rejected by VTAM, and the application may choose to 
terminate the session after a number of retries. 


BSC 3270s and IOBUF For BSC 3270 devices, VTAM will not move the input data from IOBUF to the 
application input data area (or PPBUF if no RECEIVE or READ outstanding) 
until an EOT has been received by the NCP. The NCP informs VTAM of this 
via the Extended Response Byte in the Basic Transmission Unit (BTU). The 
BTU is used between VTAM and the NCP for communications relating to BSC and 
S/S devices. It shows up in a VTAM I/O trace as an FID 0 PIU. See the 
370X Program Reference Handbook, GY30-3012, Section 8: BTU RESPONSES for 
details. Thus, if an EOT is not being received from the cluster, 
(page-fixed) IOBUF buffers will be tied up indefinitely. A hardware prob- 
lem with a 3270 cluster which never sent EOTs could conceivably bring the 
whole network down. 


Incorrect VTAM/NCP parameters If the TEXTTO parameter for the terminal, coded on the GROUP macro, is 
incorrectly specified, or is too short, the application may terminate the 
session. 


In VTAM Level 2, if the product of BUFLIM, (coded on the TERMINAL macro), 
and BUFFACT (coded in the = application major node defined = in 
VTAMLST/B.book), is exceeded by the amount of input queued by VTAM from the 
terminal, VTAM will free the buffers containing the data, and drive the 
application's LOSTERM exit. This will only occur if the application does 
not have a RECEIVE pending and VTAM must move the input to PPBUFs. If 
ACF/VTAM/VS is installed this applies only to BASIC mode sessions. The 
application may terminate the session. 


If the application program sends a message whose length is greater than the 
value specified in the MAXDATA operand of the NCP PCCU macro, the session 
will be terminated. 


BSC _ SESSION TERMINATES ABNORMALLY 


(continued) ; ; : 
Line/link error For BSC point-to-point lines, if a link failure occurs, VTAM will drive the 


application's LOSTERM exit for all terminals in session. The application 
should issue 'CLSDST'. 
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Problem Isolation Steps Reference Description 
Page(s } 
Review the console log for messages This may indicate that the session was terminated 
indicating that a path= failure because of a line problem. 
occurred. | 
Review the LOGREC MDR records. 4-89 MDR records may indicate line problems that did not 
generate netvork operator messages. 
If the problem is reproducible, 4-114 Find the reset/disconnect sequence in the trace. This 
start VTAM I/O and buffer traces 6-1 indicates where the application issued ‘CLSDST', and 
for the terminal. Also start an terminated the session. Review the sequence of events 
NCP line trace on the line. before this point. The symptom recognized by the ter- 


minal operator, output received, and input at time of 
failure may be necessary. 


Since there may be a lot of line trace data, a two-pass 
trace-printing procedure may be used. First, just 
print the VTAM I/O and buffer trace entries. If line 
trace data is needed, a second printing of the trace 
dataset, for the line trace entries around the time of 
failure, may be done. 


Documentation required for IBM Special Instructions 


Console log 
LOGREC MOR entries 4-89 
Traces gathered 


Terminal output 


CHAPTER G4 : TOOLS/SERVICE AIDS 


This section describes the various tools and service aids available 
description of each aid is included along with installation considerations, 
erences to the appropriate documentation for its use. 
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in an SNA network. A 
sample output, and ref- 
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4.0 : INTRODUCTION 


Problem Determination can be viewed as a process of 
directing questions about a component failure either to 
the affected component or to one that is closer to the 
appropriate SSCP. Most IBM hardware components generate 
information about internal failures and failures on 
their interfaces. This information 1s available to an 
operating system upon request. 


In many cases such u request will be made as soon as 
there is an indication that an operation has not com- 
pleted successfully. The maintenance data obtained in 
this way from the unit in question will be stored in a 
dataset, where it can be viewed afterwards by using a 
program. Since this type of information is automat- 
ically available after the error occured, it is 
considered to be "unsolicited" maintenance data. 


In some cases, such automatic recording will not take 
place and the maintenance data must be explicitly 
solicited before it can be viewed. 
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Performing a test usually implies that a unit, compo- 
nent or link is singled out and heavily exercised for 
the purpose of either increasing its failure rate or 
proving that it does not fail at all. The maintenance 
data obtained in this way does not differ from that 
obtained during normal operation. 


Proper failure analysis, or Problem Determination, can 
only be performed if the service person is familiar 
with the types, sources and the contents of the mainte- 
nance records in an SNA network. These relationships 
are depicted in Figure 1 on page 4-4 and will be refer- 
enced in other parts of this document. 


A trace involves the recording of all events and/or 
datastreams of one or more specified types in a 
dataset. There may or may not be any maintenance data 
recorded in a trace dataset. Since traces usually 
yield substantial amounts of data, they are not easily 
analyzed. In many cases a data reduction program or a 
data formatting program, or both should be used to 
facilitate trace analysis. 


4.10: MAINTENANCE DATA EVALUATION 


It is important to Know what maintenance data is avail- 
able in the SNA environment, and where it gets gener- 
ated. Figure 1 on page 4-4 illustrates where, in 
fundamental network configuration, the various types of 
maintenance data originate. The maintenance records, 
which are created as the result of system detected fai- 
lures appear in the bottom part of the panel, while 
trace data origins appear in the upper part. 
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Once maintenance records are retrieved, they are usual- 
ly stored in a database and can be viewed by employing 
either a batch or an interactive program. The various 
maintenance data repositories are cross referenced 
against the appropriate viewing tools in Figure 2 on 
page 4-5. 


For overview purposes, a brief summary of this mainte- 
nance data has been provided in Figure 3 on page 4-6. 
The summary descriptions given there are, for system 
generated records, enhanced in the subsequent para- 
graphs and tables. 
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> PRINTOUT 
> PRINTOUT 
TRACE 
< ACF/ < 
DATA TAP |< 1 GTF A A 
IN- —BUFFER I/O LINE 
TERNAL ~—STORAGE 


—-BF POOL 


FUNDAMENTAL 


CONFIGURATION 


SOLICITATION 
CREQMS ) 
DISPLAY |<————— 
CONSOLE 
} WNPDA |<——-—— 
D/B 
MAINTENANCE 


DATA 


RECFMS 
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V 
PRINTOUT 


Figure 1. Maintenance Data Origins 


NOTES: 


Data Repository 


| Viewing Tool LOGREC DEVICE LOG 
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1) Unsolicited records 
2) Solicited records 


Figure 2. Maintenance Data Origins vs. Viewing Tools 
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Figure 3. 
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DATABASE RECORD DEVICE DESCRIPTION Unsolicited/ 
Solicited 


Logrec 3705 -Permanent BSC/SS Device or line errors 
NPDA -Station statistics for BSC/SS 
-Type 1/4 channel adapter error 
-Type 2/3 channel adapter error 
-Type 2 scanner errors 
-Type 3 scanner errors 
-Input/Output instruction exception 
-Program level 1 interrupt request 
-Unresolved program L 3 interrupt 
request 
~SNA link permanent errors 
-~SNA station permanent errors 
-BSC/3270 status/sense 
-SNA statistics 
-Intensive mode record SNA station 
error 
-Pseudo last intensive mode record 


RECFMS 327X Link tack statistics 
TYPE 1 SNA CNTL (Used after LL2 Test) 
RECFMS 327% Summary error data 

TYPE 2 SNA CNTL (never sent unsolicited) 


NPDA RECFMS 327X Communication Adapter Data i 


TYPE 3 SNA CNTL 


RECFMS 327X Controller data (PU/LU) 
TYPE 4 SNA CNTL 
RECFMS © 327X Conti cubation EC level 
TYPE 5 SNA CNTL 


NPDA RECFNS 327X 368X modem error data 
TYPE 6 SNA CNTL (gathered and displayed by NPDA 
but not stored in database) 


TRACE DATA 
I/0,BUFF ; 


Traces events of failing component 


in a network 


LINE 


Maintenance Data Summary 


PAGE 4-6 


G.1.1 : MISCELLANEOUS DATA RECORD (CMDR) are also recorded for Buffer Overflow, Demounts, and 


Device Failures. 


MDR (MISCELLANEOUS DATA RECORD) DESCRIPTION The format of the MDR 


is described in the following 
table. 


MDRs are recorded for device failures on teleprocessing 
devices connected to an IBM 3704 or 3705 device. They 
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Source 

Always on 

Unused 

Always on 

Unused 

‘O0O0'- MDR formatted by DDR or SVC91 
"O1'- Original MDR 
"1ll'- Converted MDR 
System/Release level 
‘000'- 05/3690 

'OO1l'- BOS 

'010'- OS/VSI1 

‘Ol1'= CP67 or VM/370 


Tuo byte sub-ID field used by record 
variable-length sub-ID field used 
Reserved 

Number of characters in sub-ID field, 
starting in at byte 26(dec), lat hex). 
Sequence of the physical record. 
Total number of physical records in 
this logical record. 

Reserved 

System date when tncident recorded. 
System time when incident recorded. 
Reserved 

Version 1 CPUs 
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*100'- OS/VS2 | Version 11 CPUs 

Release level, 0 - IF Reserved 

Last record CPU serial number 

More records to follow CPU machine model number 

Time of Day clock( IBM System/360) Not used for MDR. 

(IBM System/370) Device address of data identified in 

Truncated record | this record. 

Reserved ? Identifies device in bytes 24-25. 

TIME macro used : Length(2-16 bytes) defined in byte 5. 

Reserved OR 

Not used by MDR | Device dependent information supplied 
| Record incomplete by ERP that detected error. 

Not used by MDR : : : 

Reserved 

‘OOCO01L'- IBM 3330 

"O0010'- IBM 2305 

‘OOOLL'- IBM 3270 

*O0100'- IBM 3211 

*OO101'- IBM 3705 

*O0110'- IBM 3670 

*01000'- IBM 2715 

*O1001'- IBM 3340 

‘O01010'- IBM 3330 

"01100'- IBM 3800 

‘O01110'- ISM 3850 

*10001'- IBM 3350 

*1OO10'- IBM 2305 MOD 1 

All other combinations are reserved. 


3 
0 
0 
1 
1 
2 
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TABLE 1: MDR FORMAT 


4.1.2 3: RECORD FORMATTED MAINTENANCE STATISTIC 
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(RECFHMS } 
REQMS-RECFMS DESCRIPTION 


Request Maintenance Statistic (REQMS) is sent by the 
SSCP to request that specific network management infor- 
mation be sent back via the RECFMS request. 


A REQMS is sent normally and can be recognized by its 
NS HEADER, which is X'410304'. 


An SNA controller (note 1) will respond to the REQNMS 
with the following RECFMS records: 


TYPE 1 test statistic 

TYPE 2 summary error data 

TYPE 3 communication error data 
TYPE 4 PU/LU data 


TYPE 5 E/C level or configuration 
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TYPE 6 386x error record data 
TYPE 6 3867 link diagnostic unit error record data 


Possible negative response to REQMS 1s_ sense 
X'080C0000'. This is to indicate the type code is not 
supported. 


Another negative response is X'10030000' which means: 
'function not supported’. RU-0 to RU-4 is not equal to 
X'4103040000°. 


NOTE 1: Refer to the proper terminal component 
description manual for a specific record format. 
Record Formatted Maintenance Statistic (RECFMS) is sent 
from the PU to the SSCP to communicate pertinent net- 
work management information. It 1s sent in response to 
a REQMS in which case the format of the RECFMS RU is 
dictated by the type code received in the REQMS, or is 
sent unsolicited when any communication adapter error 
counter reaches its limit threshold. 


TOOLS/SERVICE AIDS PAGE 4-9 


6624-1514-1 ACF/SNA SYSTEM PROBLEM DETERMINATION GUIDE Vol. I PAGE 4-10 


TYPE BYTE CONTENTS PU/LU DATA 


reserved 
LINK TEST STATISTIC 


bit 0, reset(notel ) 
3-4 | 
3 5-6 
7 


bit 1-7,type code= B'0000100' 
SUMMARY ERROR DATA 


3-4 x'0000° 
| 5-6 reserved 
7 i bit 0, reset(notel ) 
bit 1-7, type code= B‘'0000010' 
Cc 


| - COMMUNICATION ADAPTER DATA 


X'9000' 
reserved 
bit 0, reset(notel ) 

bit 1-7, type code= B'0000001' 


E/C LEVEL OR CONFIGURATION 


3-4 x'0000° 
5-6 reserved 
7 bit O,reset(notel ) 
bit 1-7,type code= B'0000101' 


386X ERROR RECORD DATA 


x'0000' 

reserved 

bit O,reset(notel ) 

bit 1-7,type code=B'0000110' 


x‘'o000' 
reserved 


bit 8, reset(notel } 
bit 1-7,type code= B'0000011' 


Note 1: Set to 1 if data is to be reset when RECFMS is sent. 


Table 2: REQMS Format 


BYTE DESCRIPTION 


NS HEADER X'410384¢' 


X'0000' 


Reserved.The contents of this field will 
be echoed on a solicited request and 
X'0000" on an unsolicited request. 


Solicited. Sent in reply to REQMS. 
Type code = B'0000001' 


Station ID: bits 0-11 block no. of 
sending PU bits 12-31, specified ID of 


sending PU 


Reserved 

Counter: the number of times the 
secondary SDLC station has 
received an SDLC TEST command. 

Counter: the number of times the 


secondary SDLC station has 
transmitted an SDLC TEST command. 


Table 3: RECFMS Type 01 Format (Link Statistics) 
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X'410384' 

X'0000' 

The content of this field will be echoed 
on a solicited request and X'0000' on an 


unsolicited request. 


Solicited, sent in reply to REQMS. 
Type code=B'0000010'. 


Station ID= bits O0-ll,block no.of sending 
PU bits 12-31, specific ID of sending PU. 


Reserved 

Summary counter validity mask: 

bit 0,set to O,product check counter not 
valid. 

Communication counter is valid. 

SNA error counter is valid. 

Reserved. 

Reserved 


Product check counter. 


Communication check counter. 


Count of all SNA negative response 
originated at this PU. 


Table 4: RECFMS Type 02 Format (Summary Error Data) 
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BYTE DESCRIPTION 


3-4 

5-6 

7 

8-11] 

12-13 

14 

15 
0=1 
1=1 
2=1 
3=1 
4=] 
5=] 
6=1 
7=1 

16 
0=1 
1=1 
2=} 
3=1 
G=0 
5-7 

17 

18 


Table 5: RECFMS Type 03 Format (COMMUNICATION ADAPTER DATA) 
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X*410384' 


X'0000' 
Reserved (same as previous RECFMS). 


Unsolicited. 
Solicited; sent in reply to REQMS. 


Same as previous RECFMS. 
Reserved 
Adapter type 


Communication adapter counter validity 
mask.byte 1. 


| Non-productive timeout counter is valid. 


Idle timeout counter is valid. 

Write retry counter is valid. 

Overrun counter is valid. 

Underrun is valid. 

Connection problem counter is valid. 
FCS error counter is valid. 

Primary station abort counter is valid. 


Communication adapter counter validity 
mask.byte 2. 


Command reject counter is valid. 

DCE error counter is valid. 

Write timeout counter is valid. 

Invalid status counter is valid. 

I/O machine check counter is not valid. 
Reserved. 


Reserved 


Non-productive timeout/receive overrun 
counter. 


BYTE iol ae DESCRIPTION 


Idle timeout counter 


Write retry counter 


Overrun counter 

Underrun counter 
Connection problem counter 
FCS counter 

Primary station abort 
Command reject counter 

DCE error 

Write timeout counter 


Invalid status counter 


TOOLS/SERVICE AIDS 


I/O machine check counter (not valid) 
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| DESCRIPTION 


X'410384' 


X"'0000'° 


Reserved. The contents of this field will 
be echoed. 


Solicited | 
Type code=B'0000101' 


Station ID 


Reserved 


Microcode level 


Table 6: RECFMS Type 05 Format (E/C LEVEL or CONFIGURATION) 


Table 7: RECFMS Type 06 - 386x Modem Error Record (Part 1 of 2) 
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X'410384¢' 


SM target identification 


reserved 
CSM target descriptor 
procedure related identifier 


solicitation indicator 
not-last-request indicator 
type code=B'000110' 


block number 
sending PU identifier 


reserved 


X'02' request echo for link status and 
test. 
X'03' request echo for DTE interface 
status. 


X'O1' Link subsystem type (386X) 
X'03' to X'ff', reserved 


Control byte 1 
B'CO' Valid remote probe status 
~other- Invalid remote probe status 
(indicates usability of bytes 18,19) 
B'00" Valid local probe status 
-other- Invalid local probe status 
(indicates usability of bytes 20,21) 
B'00' Valid probe self test 
-other- Invalid probe self test 
(indicates usability of bytes 22,23,24) 
Reserved 


Control byte 2 

B'0O' Valid DTE int'face status 
~other- Invalid DTE int'face status 
(indicates usability of bytes 25,26) 


Reserved 
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Remote probe status byte 1 

Zeros, not used 

Probe reinitialization indicator 
Carrier loss in data mode indicator 


Remote probe status byte 2 

Byte errors during test 

Remote DTE power off indicator 
Remote DTE ready dropped indicator 
SNBU connected 

Streaming indicator 


Local prebe status byte 1 

Zeros, not used 

Probe reinitialization indicator 
Carrier loss in data mode indicator 


Local probe status byte 2 

Byte errors during test 

Remote probe power loss indicator 
Always B'l' Full speed 

SNBU connected indicator 

Reserved ~ 


Probe self test byte 1 

Always B'L' 

Always B'lL' 

Always B'1' 

B'O' Leased line - B'1' Switched line 
B'O' Point-to-point - B'l' Multipoint 
B'O' Primary sta. - B'l' Secondary sta. 
Reserved 

Raserved 


Probe self test byte 2 

Always B'1' 

Local self test failed (only when bit 
2 is off} 

Remote tone test failed 

Suspect TAC failure 

Zeros, not used 

Reserved 
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Probe self test byte 3 

B‘'O' TAC not installed - B'l' inst'ld 

B‘'O* No SNBU - B'1* SNBU installed 

B'O' No CHANNEL - B‘'1' CHANNEL inst'ld 
| Zero, not used SO 

Microcode EC level 


Remote DTE interface current status 
B'l' Request to send is on 

B'l' Clear to send or ready for s'ndng 
Reserved 

B'l' Transmitted data 

Reserved 

B'l' Data terminal ready 

Always B'l' Full speed 

B'l' DTE power off 


0 
i 
2 
3 
4 
5 
6 
7 


Remote DTE interface transient status 
B'l' RTS has been up at least once 

| B'L' CTS has been up at least once 
B'l' RD - data has been received 
B'l’ TD - data has been transmitted 
B'l‘ CD - carrier loss at least once 
B'l' DTR - ready dropped at least once 
B'l' Speed change at least once 
B'l' DTE power loss at least once 


VIO UD GLP HH 


{ 
\ 


Table 8: RECFMS Type 06 - 386X MODEM ERROR RECORD (Part 2 of 2) 
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4.1.3 3 INTENSIVE MODE RECORDING CIMR) 


DESCRIPTION 


The operator can request detailed information concern- 
ing temporary line errors or other hardware conditions 
using Intensive mode recording (IMR). The error infor- 
mation can be requested for an SDLC communication Link 
between an NCP and one of its peripheral PUs, or 
between two NCP major nodes. 


Recording occurs when any of the following conditions 
are encountered: 


® Permanent hardware errors 

¢ Temporary hardware errors 

*¢ Counter overflow 

®  End-of-day 

Intensive mode recording can be used closely with an 
ACF/VTAM Line Trace to analyze temporary line errors. 


Using the time stamp on the IMR record, we can deter- 
mine where to look in the line trace. 


OPERATION 


For intensive mode recording, the link between the NCP 
and PU or the two NCPs, whichever the case, must be 
active. 


To start intensive mode recording, specify: 
MODIFY procname, IMR ,ID=nodename 


( ,RECLIM=n) 
(,OPT= ACT;,INACT) 
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When the FPECLIM value (maximum number of temporary 
errors that are to be recorded for the named link sta- 
tion or PU, default 10) is reached, or IMR is cancelled 
with OPT=INACT, the NCP reverts to sending only perma- 
nent error records to ACF/VTAM. 


ACF/VTAM converts each IMR record to a miscellaneous 
data recorder (MDR) record. MDR records are written to 
the SYS51.LOGREC dataset in OS/VS systems or to the SYS- 
REC file in VSE systems. Refer to Section 4.1.1 for the 
format of the MDR record. 


If the Network Problem Determination Application (NPDA) 
is installed, ACF/VTAM can send a copy of the IMR 
records to NPDA. Refer to the section on NPDA for 
information on how to display the records. 


SOFTWARE DEPENDENCIES 


The following software must be at least at the speci- 
fied levels: 


ACF/NCP R2.1 


Ad ACF/VTAM R2 


NCCF RI 


° NPDA 2 


REFERENCE MANUALS 


® ACF/VTAM Operation... . . SC27-0612 


®  ACF/VTAM Diagnosis Guide . . SC27-0615 (0S/VS) 
- « SC27-0615 (VSE) 
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4.2 : INTERACTIVE PROBLEM DETERMINATION TOOLS 


The interactive Problem Determination Tools represent 
the state-of-the-art and should be employed wherever 
possible. Most of them are driven by actual problems 
that are detected by the system, and among their many 
advantages are the following: 


¢ Fast remote problem determination. 


© Immediate, interactive access to maintanence data- 
bases. 


e Immediate execution of tests, often without even 
~ the need to take the units under test offline. 
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¢ Immediate awareness of developing communications 
problems through unsolicited, threshold-driven 
alerts. 


e Immediate, interactive access to historical problem 
data. 


© Immediate, interactive access to network configura- 
tion data. 


It should be noted that the accent is on the immediate 
and interactive properties of these tools. In a modern 
network, where high availability is important, these 
properties are of the utmost importance. 


4.2.1 3: NETWORK COMMUNICATIONS CONTROL FACILITY (NCCF } 


DESCRIPTION 


Basic network control, in a given SNA domain, is accom- 
plished with the ACF/VTAM commands described in chapter 
5. The Network Communications Control Facility (NCCF) 
program product offers the following advantages in an 
ACF/VTAM environment: 


e It allows dedicated network consoles, ji.e., sepa- 
rating the network message traffic from host con- 
trol and subsystem control messages. 


® Operator access control, along with its security 
and auditing advantages, is achieved through a 
password-protected logon. Under MVS, the password 
may be RACF controlled. 


® A continuous log of operator activity is maintained 
via the NCCF Log. 


® A hardcopy log is supported. 

® Operator Keystrokes can be significantly reduced 
for repetitive command sequences through the use of 
command lists (CLIST). 

e =6h AN. sCoperator's span of control can be defined to 
include all ACF/VTAM defined network resources, or 


a defined subset. ee 


® A network operator can be authorized to issue all 
available commands, or a defined subset. 
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e NCCF supports exit routines, which may be used to 
examine and edit NCCF Commands and messages. This 
permits extended use of CLISTs via user definable 
Program Function Keys (PFKs). 


° Timer initiated command support is available. 


e User detined commands can be designed and imple- 
mented via the NCCF Command Processor support 
facility. 


e Commands can be given user-defined names. 


® IBM Command Processor P/Ps can be installed and 
operated under NCCF, notably the Network Problem 
Determination Application (NPDA) and the 
Info/System program products (Info/Management - 
Info/MVS - Info/Access). 


e Cross-Domain network control is achieved through 
NCCF to NCCF sessions, which provides an unre- 
stricted view of cross-domain resources and also 
permits cross-domain problem determination. 


® NCCF operates in the environments shown in Figure 4 
on page 4-20. 


¢ NCCF is parameter driven and requires no generation 
for installation. 


This chapter does not cover the new functions provided 
by NCCF Version 2. A future revision of this guide will 
reflect the new features of NCCF Version 2. 
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Mae 


NCCF Relesses 1 and 2. 


wea rere y: 


: 


User [CNM  [Seort! rjData Data Cross- {Span of 
Custom-| Inter f=; Control |Security/|Services |Domain{Control 


| Functions 
Presentation Services Services Unique 
to NCCF 
CLISTS eect Full- Full- Release 2 
NCCF Line iScreen 
lzation | S.opoery Auditing | 
VTAM Level 2 
OS/VS2 MVS; Os/VS x 4 
ACF/VTAM ewue 1 
OS/¥°° CENS5) OS/VS1 Xx x Xx 
| ACF/VTAM Paldace 2 | . | 
OS/VS2CMVS) x Xx 
1OS/VS1, VSE 


|ACF/VTAM Release 3 
OS/VS2(MVS) 


OS/VS1, VSE 


dh ee ee ee 


Figure 4. NCCF Capabilities in Various Environments 


NCCF PROBLEM DETERMINATION HIGHLIGHTS 


Problem Determination often starts in NCCF. Using the 
NCCF CLIST capability, a fully customized set of prob- 
lem determination procedures can be developed and made 
available to the network operators, which can make it 
easier to perform PD in the home domain, and enables it 
in a cross-domain. In addition, a dictionary of mes- 


e ACF /VTAM 


REFERENCE MANUALS 


e NCCF General Info .. 


sage explanations can be put online. ® NCCF 

A series of examples is provided in this section. Also @ NCCF 

of particular value is the NCCF log, which records all 

events that have taken place in the NCCF address space. @  NCCF 
e NCCF 
e NCCF 

AVAILABILITY e NCCF 

IBM Program Product 5735-XX6 ®  NCCF 
® NCCF 

PRODUCT DEPENDENCIES ® NCCF 

® VSAM (for NCCF Rel. 2 log) 
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R2 
Re 
R2 
R2 
Re 
V2 


V2 


Ve 


V2 


Installation . 
Messages ... 
Terminal Use . 
Customization 
Logic. .« « « « 
Installation . 


Customization 
Command Lists 


Customization 


- 6027-0429 
- 3C27-0430 
~ $C27-0431 
- SC27-0432 
- $€27-0433 
- LY38-3010 
- $C27-0660 


- $C27-0661 


- SC27-0662 


Command Processors 


Operation. .. 


- SC27-0664 
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OPERATION 


NCCF can be operated from any number of locally or 
remotely attached terminals, as well as from terminals 
located in another domain. 


Only defined operators are permitted to log-on to NCCF. 
Each operator has a personal password to verify his/her 
logon authority. The password can be controlled by 
NCCF, or, if desirable in an MVS environment, by RACF 
(Resource Access Control Facility). 


NCCF provides for an action-oriented, line by line, 
wraparound display. The wrap mode can be turned on or 
off under operator control. 


As distributed, NCCF supports the ACF/VTAM command set 
plus a set of its own commands. Since» in principle, 
it is a command driver of considerable flexibility, the 
usable command set can be customized by the user as 
follows: 


® All commands can readily be re-named and synonymed 
for convenience. This permits the use of synonyms 
in languages other than English. 


® Program function keys can be set to execute many 
commands. 


* Commands can be removed, thus made inoperable. 


* User developed commands (verbs and processors) can 
be added to the command set. 


The number of operator keystrokes can be significantly 
reduced through the use of CLISTs, which allow the 
grouping and executing of commands under user defined 
names. CLISTs may also be executed from PFKs. In this 
case, however, a user written NCCF exit routine must be 
provided which translates the code returned by the PFK 
into a PDS member name. (Refer to the NCCF Customiza- 
tion manual for sample exits.) 


OPERATOR PROFILE DEFINITION 


An operator may be given global control over all the 
network resources in a given SNA domain. Optionally, 
however, his/her profile may be set up to limit his 
span. of control, ji.e., hide specific resources from 
his/her vien. This is accomplished via the "scope of 
control" facility. 
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Another facility, called "scope of commands", may be 
used within an operator's profile to restrict the range 
of commands, keywords, and Keyword values available to 
him/her. This means that the available command set may 
be divided into command classes at the option of the 
user. Operators can then be permitted to execute com- 
mands of predefined classes only. 


COMMAND SUMMARY 


This section summarizes all of the commands in the ori- 
ginal syntax. The table lists the commands in alpha- 
betical order by command name. Operands are shown only 
when necessary. 


The “Type” column indicates whether the command is reg- 
ular (R), immediate (I}, both regular and immediate 
(B), or regular and data services (RD), or not applica- 
ble for the command type (N). 


The "Where" column indicates where details about the 
command can be found. The entries have the following 
meanings: 


VTAM An ACF/VTAM command. Refer to ACF/VTAM pub- 
lications for the description. 


NCCF An NCCF command, summarized here and found in 
NCCF manuals. 


The "Span" column indicates whether or not the command 
can be restricted by span of control. 


The last four columns indicate from where the commands 
may be issued. The column headings and their meanings 
are as follows: 


TERMINAL: The operator may issue the command at the 
physical operator station. 


COMMAND LIST: The command may be used in a command 
list. 


SYSTEM CONSOLE: The command may be entered from the The numbers in the columns refer to the notes that fol- 
system console to NCCF. low the table. 


COMMAND PROCESSOR: The command may be issued by a com- 
mand processor to NCCF. 
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Command 


AGAIN 
AUTOHWRAP 
CANCEL 
CLEAR Key 
clistname 
CLOSE 
DISPLAY 


no data enter 
PAUSE 

REPLY 

RESET 

ROUTE 

START 

START 

STOP 

SRITCH 

user command 
VARY 


SPAN 
Applies 


ie 


) 


u 
Bs 
I 
I 
R 
I 
R 
I 
N 
R 
R 
N 
N 
R 
R 
p 
I 
R 
R 
I 
R 
N 
R 
R 


AJ 
we 
mM MK K x KOK xm KM HUUK KR MK KK KK KK 


mK «MK MR Mh RK KKK 


a 


Table 9: NCCF Command Summary 


The generated commands are checked, 


Establishes 


Only regular and RD commands may be repeated. 


the original command is 
not. 


Goes directly to the access method, not to NCCF. 


an SNA session between the terminal and the 
device message handler or NCCF application program. 


Data is énteped from the termial, but is received by the 
access method and becomes available to NCCF only through the 
facilities of the LOGON exit. 


Terminal} CLIST 
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} Assued From } Assued From 


System 
Console 


10. 


Command 
Processor 


MxM MK HK Mm KK am KK 


Data is entered from the terminal but is received by ACF/VTAM 
and results in entry to the NCCF LOSTERM exit routine. 


Goes directly to ACF/VTAMN or to NCCF. 


Applies to STARTISTOP (resourcelspan) only. 


Breaks the SNA session between the SNA device and the device 
message handler or NCCF application program. 


Defined by user as R,I,B,D, or RD. 


AGAIN 


AUTOWRAP YES|NO 


CANCEL 


| clistname [operand...] 
CLOSE [NORMAL | IMMED | DUMP ] 


DISPLAY NET, ID=[domainid.1] name »EVERY|E, 
[domainid. ] MAJNODE 
BFRUSE 
APPLS 


TERMS 


LINES 
CDRMS 
CDORSCS 


D 
LIST CLIST=clistname 
PROF ILE=profilename 


stationname|'' 

helname 

terminalname 

taskname 

SPAN=spanname 
STATUS=(NNT | OPS| TASKS |OPT|SPANS] PROFILES) 


LOGOFF 


| LOGON APPLID(applid) [LOGMODE (DSILGMOD)] 


MODIFY NET, DUMP, ID=[domainid.] ncpname [,RMPO|DYNA] 
F NEGPOLL=number ,ID={domainid.] linename 


[domainid. ] NETSOL=( YES|NO) 

POLL=number ,ID=(domainid.] Linename 
SESSION=number,ID=[domainid.] lLinename 

[domainid. ] SUPP=... 

Cdomatnid.] TEST 

TRACE, ID=[domainid.] name, TYPE 

NOTRACE,ID=[ domainid.] name,TYPE=... 

TRANLIMN=number ,ID=[domainid.1 terminalname 
[domainid.] TNSTAT [...] | Edomainid. 1] NOTNSTATI... 


| MOVE FROM=terminalname, TO=terminalname 


G 
SY 
PO 
& 
é 
fond 
Ss 
font 
of 
{ 
— 
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(LOG|ALL|SYSOP|stationname), text 
PAUSE [text] 
R 


REPLY Pon|[Lnn, text 


RESET [NORMAL | IMMED [DUMP] 


ROUTE domainid,command text 


OP=stationname 

HCL=helname [,0P=(stationname|"|ALL)] 
CDOMAIN=domainid 

TERM=terminalname 

SPAN=spanname [,0P=stationname|"'] 
RESOURCE=resourcename 

TASK=taskname 


OP=stationname 
HCL=helname [,0P=(stationname|]"|ALL)] 
DOMAIN=domainid 

TERM=terminalname 

SPAN=spanname [ ,OP=stationname|''] 
RESOURCE=resourcename 

FORCE=( taskname|[helname| terminalname) 


SWITCH taskname,(P|S|T) 


VARY NET, ACT, ID=[domainid.] name 

INACT [,CI]F[R)] ,ID={domainid.] name 

PATH=(NOUSE |USE),(PID=n|GID=n),ID=[domainid.] name 
INOP,ID=[domainid.] Linename [,END] 


Ai 


Table 10: NCCF Command Quick Reference 


INTERPRETATION 2. Cross-domain examples, which are subdivided into: 


a. Starting an NCCF to NCCF cross-domain session 
This section has a number of examples which are organ- 
ized as follows: b. Performing Inquiries in another domain 
1. CLIST examples, which show how the operation of the 3. 


network can be simplified for the network operator 
when CLISTs are used. 


Example of an NCCF log printout 


Please note that the CLIST capability provides the 
user with a great deal of "personalized" command 
flexibility. None of the CLISTS shown in the subse- 
quent examples are delivered as part of the NCCF 
product, they have all been created as samples by 
the authors of this publication. In one case a 
source listing has also been sheoun. 
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EXAMPLE 1: 


CLIST EXAMPLES 
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The following CLISTs are examples of how the network operator's job can be simplified, and how 


errors and Keystrokes can be reduced. 


These examples have been created and tried by the authors,» 


but the users are invited to customize them or create their own. 


NCCFL 


NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 


CLIST ILLUSTRATION 1: DIS 


The CLIST "DIS" creates a D NET;,... command 


and in turn calls imbedded CLISTS by the same 
name as selected ACF/VTAM ISTxxxx messages. 


"DIS" CLIST entered here 
14:00:33 * DIS LU360260 


Response starts here 
C Enter: ST or STATUS xxxxx(xxxxx) for status description 
DISPLAY NET,ID=LU360260,E 


14:00:33 
14:00:34 
14:00:34 
14:00:35 
14:00:35 
14:00:35 
14:00:35 
14:00:35 
14:00:35 
14:00:35 
14:00:35 
14:00:35 


Cc 
Cc 


DSIOLSI 


ISTO75I 


IST¢861 
ISTO81I 
IST1351 
IST6751 
IST3141 
ISTO82I 


. 
° 


COMMAND LIST DIS COMPLETE 

VTAM DISPLAY - NODE TYPE= LOGICAL UNIT 
NAME= LU360260 ,STATUS= ACT/S 

LINE NAME= L36026 » LINE GROUP= G36S2 
PHYSICAL UNIT= PU36026 =; 

VR = 0, TP = O 

END 

The device type 1s LU. 

It is in session with LNETMON. 

The assigned application is LNETMON. 


»DESIRED STATE= ACTIV 
» MAJNOD= N36R21 
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Source listing of the CLIST "DIS". 
Provided as a sample only. 


&CONTROL CMD 

&IF .&1 EQ .? &THEN &GOTO -TELL 

&IF .&1 EQ . &THEN &GOTO -TELL 

&WRITE Enter: ST or STATUS xxxxx(xxxxx) for status description 
&IF &l APPLS &THEN &GOTO -SHRT 


&IF &1 = CLSTRS &THEN &GOTO -SHRT 
SIF &1 = TERMS &THEN &GOTO -SHRT 
&IF &1 = LINES &THEN &GOTO -SHRT 
&IF &1 = CDRMS &THEN &GOTO -SHRT 
&IF &1 = PATHS &THEN &GOTO -SHRT 
&IF &1 = CDRSCS &THEN &GOTO ~SHRT 
&IF &1 = BFRUSE &THEN &GOTO -SHRT 
&IF &1 = MAJNODES &THEN &GOTO -SHRT 
&IF &1 = PENDING &THEN &GOTO -SHRT 
&IF &1 = PATHTAB &THEN &GOTO -SHRT 
&IF &1 = P &THEN &GOTO -SHRT 

&IF &1 = NCPSTOR &THEN &GOTO -NCPS 
&IF &1 = CLSTRS &THEN &GOTO -SHRT 
&PAR2 = &2 


&IF .&PAR2 EQ . &THEN &PAR2 = E 
*¥HRITE DISPLAY NET, ID=&1, &PAR2 
DISPLAY NET, ID=&1,&PAR2 

&EXIT 

-SHRT 

DISPLAY NET,&1,&2 

&EXIT 

-NCPS 

&IF &PARMCNT GT 3 &THEN &GOTO -PAR3 
DISPLAY NET,&1,ID=&2,ADDR=&3 

&EXIT 

~PAR3 

DISPLAY NET, &1,ID=&2,ADDR=&3, LENGTH=&4 
&EXIT 

~TELL 


&WRITE This CLIST requires one parameter; the second is optional. 


&HRITE DIS nn nn 
&WRITE Basic VTAM format: DISPLAY NET,ID“userid,<E | A | I> 
&EXIT 
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NCCFL 


NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 


"STATUS" 
14:00:44 


Response 
14:00:44 
14:00:44 
14:00:44 
14:00:44 
14:00:45 
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CLIST ILLUSTRATION 2: STATUS 


The "STATUS" CLIST is particularly useful for 
problem determination, since it explains status 
information on the screen. 


This information can be enhanced to make it 
more understandable for the operator. 


CLIST entered here 
* STATUS ACT/S 


starts here 
C ACT... Active 


C The resource 15 in the active state. ACTIV terminals 

Cc with no active or pending-active sessions will have 

Cc ACT-NOSESS status in response to DISPLAY TERNS. 

C .../5 A session is in progress for this logical unit or terminal. 
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NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 


NCCFL 
NCCFL 


NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
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CLIST ILLUSTRATION 3: DIS and STATUS 


DIS CLIST entered here. 
15:36:53 * DIS LSSCMVS2 
15:36:55 C Enter: ST or STATUS xxxxx(xxxxx) for status description 
15:36:55 C DISPLAY 
15:36:56 C DSIOI3I 


NET, ID=LSSCMVS2,E 
COMMAND LIST DIS 


COMPLETE 


VTAM DISPLAY - NODE TYPE= CDRM 


»STATUS= ACTIV 


CDRM TYPE = EXTERNAL ;,SUBAREA = 032 
PREDEFINITION OF CDRSC = OPT 


ZTSO ACTIV 
ZIIS ACTIV 
ZIN3 ACTIV 
ZIM6 ACTIV 
ZIMX ACTIV 


ZNETOPR ACTIV 


ZTSOO0O!1 ACT/S----Y NCCFZ000 ACT/S----Y 


15:36:57 ISTO75I 

15:36:57 IST486I NAME= LSSCMVS2 
15:36:58  IST4¢76I 

15:36:58  IST389I 

15:36:58  IST4¢78I CDRSCS: 
15:36:58  ISTO80I NCCFZ ACTIV 
15:36:58  ISTO80I ZCICS ACTIV 
15:36:58 ISTO80I ZIM2 ACTIV 
15:36:58  ISTO80I ZIMS ACTIV 
15:36:58  ISTO80I ZIM6F ACTIV 
15:36:58 ISTO80I ZHELP ACTIV 
Reponse contains complex status codes. 
15:36:58  ISTO80I ZVSPC ACTIV 
15:36:58  IST314I END 


Status CLIST explains most status codes. 
STATUS ACT/S---~-Y 
ACT.. Active 


15:37:21 
15:37:23 
15:37:23 
15:37:23 
15:37:23 
15:37:23 
15:37:24 


* 


C 
Cc 
C 
C 
C 
C 


The resource 


is in the active state. 
with no active or pending-active 


Another example of "DIS" with subsequent "STATUS" 


»DESIRED STATE= ACTIV 


ZJES2MVS ACTIV 


ZIMl ACTIV 
ZING ACTIV 
ZIMGA ACTIV 
ZNETMON ACTIV 
ZFCO ACTIV 


ACTIV terminals 
sessions will have 


ACT-NOSESS status in response to DISPLAY TERMS. 


---/S A session is in progress for this logical unit or terminal. 


..-eY This cross-domain resource was created dynamically. 


TOOLS/SERVICE AIDS 


PAGE 4-31 


6624~-1514-1] 


NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 

‘CCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 


NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
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CLIST ILLUSTRATION 4: STATUS 


Example of 2 "STATUS" CLISTs 


“PCTD2" is the status code queried. 
* STATUS PCTD2 
C PCTD2 Pending Contacted (2) Response 


15:38:11 
15:38:11 
15:38:11 
15:38:11 
15:38:11 
15:38:11 
15:38:11 
15:38:11 
15:38:11 
15:38:11 
15:38:11 
15:38:11 
15:38:11 
15:38:11 


Saoana»aIanannan 


Cc 


A node such as a link station or a PU, is being activated 

and the final contacted request was sent to the appropriate 
PU services and the response received, but the associated 
Contacted request was not received. A communication 
controller will also be found in this state (it is a 
suspended state in this case) during activation while waiting 
for a link station connected to it to be activated; the 
difference between PTCD2 and PCTD] is that a communication 
controller in the PCTD1 state may be loaded if a link station 
receives a Contacted request indicating the NCP needs to be 
loaded, whereas in the PCTD2 state, both the link station and 
the NCP would be deactivated. 


"PANNA" is queried. 

15:38:36 * STATUS PANNA 

15:38:37 C PANNA Pending Allocate Node Network Address 
15:38:37 C 
15:38:37 C 
15:38:37 C 
15:38:37 C 


A node, for example, a DR added, PU or LU, is being 
activated, and the Request Network Address Assignment 
request was sent to the appropriate PU services, but the 
associated response was not received. 
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NCCFL 
NCCFL 
NCCFL 

ICCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
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CLIST ILLUSTRATION 5: SENSE 


The "SENSE" CLIST explains sense information 


The SENSE CLIST explains most sense codes. 
15:39:00 * SENSE 0806 
"0806" 1s queried. 


15:39:60 
15:39:00 
15:39:00 
15:39:00 
15:39:00 
15:39:00 
15:39:00 
15:39:00 
15:39:00 
15:39:00 


C 
Cc 
Cc 
Cc 
C 
C 
C 
Cc 
Cc 
C 


DSI2191 COMMAND LIST SENSE - STATEMENT ECHO SUPPRESSED 
¥ REQUEST REJECT CATEGORY CODE = X'08' 


* Modifier (Cin hexadecimal): 
x 


* 06 Resource Unknonun: The logical unit, physical unit, link, or 
¥ link station name specified in a request is not Known to the 
* receiver. 

* 


DSIO13I COMMAND LIST SENO0806 COMPLETE 
ENTER : SENSE 08 for general description of sense category 
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NCCFL 
NCCFL 
NCCFL 


NCCFL 
NCCFL 


15:51:20 


15:51:20 
15:51:20 
15:51:20 
15:51:20 
15:51:20 
15:51:20 
18:51:20 
15:51:21 


15:53:05 
15:53:06 
15:53:07 


15:54:29 
15:54:29 


AaAaAAAAAN 


Cc 
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CLIST ILLUSTRATION 6: LL2 with prompting 


Example of CLIST prompting: if the parameter 


tLe: 


isa "?", it is a "help" request. 


For Link Level 2 Test enter: 


LL2,id 


( ,CANCEL| CONTI NTRANS=101N) 
( »,NFRAMES=1 In) 


( DATA=data) 
DSIOL3I COMMAND LIST LL2 


KEKKKKKKE 


link station or PU name 
default 

KHKHKKHRHR 

default 

HHKKKKHH 

optional 

COMPLETE 


KRKKKKKRKH 


Parameters can now be entered as per instructions. 


LL2 PU36026,NTRANS=300 »,DATA=ABCDEFGH 
F NET,LL2,ID=PU36026 ;>NTRANS=300 ,DATA=ABCDEFGH 


DSIO13I COMMAND LIST LL2 


COMPLETE 


IST549I LL2 TEST FOR ID= PU36026 ENDED WITH ERRORS 


IST243I FRAMES SENT = 00300 RCVD = 00247 RCVD WITHOUT ERRORS = 00247 
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This CLIST is intended to execute a 
LL2 test, which is further explained 
in section 4.2.2. The ACF/VTAM 
command required has a complex stuc- 
ture which needs further explanation. 
The operator, therefore, asKs for 
prompting. 


EXAMPLE 2: ESTABLISHING A CROSS-DOMAIN NCCF TO NCCF SESSION 


The following commented printout matches the NCCF screen displays for establishing a cross-domain 


session between two NCCFs. 


“NCCFZ". 


NCCFL 
NCCFL 
NCCFL 
NCCFL 

NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
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12:34:45 


12:34:45 
12:34:45 
12:34:45 
12:34:45 
12:34:45 
12:34:45 
12:34:45 
12:34:45 
12:34:45 
12:34:45 
12:34:45 
12:34:45 
12:34:45 
12:34:45 
12:34:45 
12:34:45 
12:34:45 
12:34:45 
12:34:45 
12:34:45 
12:34:45 
12:34:45 
12:34:45 
12:34:45 
12:34:45 


CANMAQANAANAAAAAAAAAAH+« * 


rmaan ti 


DSIO20LI OPERATOR HEINZ 


WELCOME 


Operator 'HEINZ' Logging on 
to home-domain NCCF 


The initial logon CLIST is named "WELCOME"; 
1t invokes a second CLIST by the name "WHO" 


which shows all home-domain and cross-domain 
operators currently logged on. 


The lefthand column identifies the NCCF 
that displays the message. 


LOGGED ON FROM TERMINAL LSLO6D 
) 


DSI082I AUTOWRAP STARTED 


CLEAR 


KH HHH HHH HK HH HH KKK HH KKK KKK KKHHK HK KKK HK KKK KK KK KKK KEKKKKKKKKKKK 


* * KK OK OK OK K OK 


WELCOME TO THE LARGE SYSTEMS SUPPORT CENTRE 


SNA DEMONSTRATION NETWORK 


* KK KK KK K K 


HHH HK HK HH KH HK HHH KKH IH HK HHH HK KH KKK HHH HHH KKH HHH KK KKK KK KKH KKHKHKHK 


% 


OP 


ERATOR: HEINZ 


°° e 


==> THESE HOME-DOMAIN OPERATORS ARE LOGGED ON <== 
| 


~  V 


TERM: LSLO6D STATUS: ACTIVE 


END OF STATUS DISPLAY 


* 


MA 


> THESE CROSS-DOMAIN OPERATORS ARE LOGGED ON <== 


e ° 


e e V 


X SESS: 00000008 


NO ACTIVE NCCF TO NCCF SESSIONS FOUND 


TOOLS/SERVICE AIDS 


The home-domain NCCF is named "NCCFL", while the other domain name is 


USING PROFILE(GLOBAL 
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NCCFL 
NCCFL 


NCCFZ 


NCCFL 
NCCFL 
NCCFL 
NCCFL 


NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
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Contacting the NCCF in the other domain via 
the command: 


"START DOMAIN=domain" 


12:35:01 % START DOMAIN=NCCFZ 


12:35:02 - DSIO33I NCCFZ 


13:28:49 


13:28:49 
13:28:49 
13:28:49 
13:28:50 


13:28:50 
13:28:51 
13:28:51 
13:28:51 
13:28:51 
13:28:51 
13:28:51 


* 


C 
C 
Cc 


SESSION STARTING FOR HEINZ 


The cross-domain NCCF (NCCFZ) prompts for a user 
ID and password to complete the cross-domain 
logon. Note that the ID of the NCCF at which 


the message originates is listed in the left 
margin. 


DSI809A PLEASE ROUTE OPID,PASSWORD,PROFILE,HARDCOPY,INITIAL CMD 


Displaying the status of the cross-domain 
NCCF using the "DIS" CLIST. 


DIS NCCFZ 
Enter: ST or STATUS xxxxx(xxxxx) for status description 
DISPLAY NET,ID=NCCFZ,E 


DSI0131 COMMAND LIST DIS COMPLETE 


The following display shows that NCCFZ is an 
active cross-domain resource under the 
cross-domain resource manager LSSCMVS2. 


ISTO75I VTAM DISPLAY - NODE TYPE= CDRSC 
IST486I NAME= NCCFZ sSTATUS= ACTIV 
IST4¢791 CDRM NANE = LSSCMVS2 

IST1L71I ACTIVE SESSIONS = 0000 SESSION REQUESTS = 0000 
IST206I SESSIONS: 

IST172I NO SESSICNS EXIST 

IST314I END 


»DESIRED STATE= ACTIV 
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NCCFL 


NCCFZ 
NCCFZ 


NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
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Routing the user ID "HEINZ" and the 
password "PSHD" to the cross-domain NCCF. 


13:32:22 * ROUTE NCCFZ,HEINZ,PSWD 


13:32:58 
13:33:05 


13:33:05 
13:33:10 
13:33:10 
13:33:10 
13:33:10 
13:33:13 
133333133 
13:33:13 
13:33:13 
13:33:14 
13:33:16 
13:33:16 
13:33:16 
13:33:16 
13:33:16 
13:33:19 
13:33:19 
13:33:19 
13:33:19 
13:33:19 
13:33:19 
13:33:19 
13:33:19 
13:33:22 
13:33:22 
13:33:23 


raAagaAgNanandaanannaanng * I 


roan it 


The cross-domain NCCF replies and indicates 
that 1t has processed the logon request. 


The CLIST "KHO", which is automatically 
executed at logon time, shows that user 
"BILL" is logged on from a hoeme-domain 
terminal, while user "HEINZ" is logged on 
cross-domain from the NCCFZ perspective. 


DSI810I NCCF ACF/VTAM READY 

DSIO20I OPERATOR HEINZ LOGGED ON FROM TERMINAL NCCFLO00 USING PROFILE(GLOBAL 
},HCL( ) 

WELCOME 

AUTO ON 

CLEAR 

HHH HK HHH HHH HEHE HHH HEH HEHEHE HEHEHE HEHEHE HEHEHE IEE HEHEHE HEHEHE HEHEHE HER HE 


WELCOME TO THE LARGE SYSTEMS SUPPORT CENTRE 


SNA DEMONSTRATION NETWORK 


K KK KK K KK XK 
KK KK KK KK K 


HHH HIE HEHEHE HEHEHE HE HEHEHE HK HEHEHE HEHE HH HHH EHH HHH HEE HEHE HHH HEHEHE HHH HHH HHH HK KK 
* 
===> THESE HOME-DOMAIN OPERATORS ARE LOGGED ON <== 
° © ° ° « ° | 

° « e « e e V 

OPERATOR: BILL TERM: LSZ020 
END OF STATUS DISPLAY 


STATUS: ACTIVE 


===> THESE CROSS-DOMAIN OPERATORS ARE LOGGED ON <== 
« ° ° * e ° | 

oe «© © « & V 

MAX SESS: 00000008 


OPERATOR: HEINZ TERM: NCCFLOOO STATUS: ACTIVE 
END OF STATUS DISPLAY 
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EXAMPLE 3: PERFORMING A CROSS-DOMAIN INQUIRY 


The following example shows how inquiries can be directed to the cross-domain NCCF. 


NCCFL 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 

ICCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 


NCCFL 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 


N 


14:35:28 * ROUTE NCCFZ,MAJNODES 


14:36:03 * MAJNODES 


14:36:06 C DISPLAY 


14:36:10 
14:36:10 
14:36:10 
14:36:10 
14:36:10 
14:36:13 
14:36:13 
14:36:17 
14:36:17 
14:36:17 
14:36:17 
14:36:41 
14:36:41 
14:37:07 
14:37:07 
14:37:07 
14:37:08 
14:37:08 
14:37:11 
14:37:11 
14:37:11 


ISTO97I 
IST3501 
ISTO89I 
ISTO89I1 
ISTO89I 
ISTO89I 
IST089I 
ISTO89I 
ISTO89I 
ISTO89I 
ISTO89I 
ISTO89I 
IST089I 
IST089I 
ISTO89I 
ISTO89I 
ISTO89I 
ISTO89I 
ISTO89I 
ISTO89I 
IST3141 


14:37:14 C DSI013I 


NET ,MAJNODES 


DISPLAY ACCEPTED 
VTAM DISPLAY - 


VTAMSEG 
ZATSO 
ZACICS 
ZAINS 
ZANSOL 
ZANCCF 
ZAJES 
CDRSCHAO 
CDRSCHAL 
CDRSCLAI 
CDRSCLA2 
ZLOCALO2 
ZLOCALO3 
ZLOCALO6 
ZCONSOLE 
N37R21 
CDRSCRLO 
CDRNZ 
END 


TYPE= 
TYPE= 
TYPE= 
TYPE= 
TYPE= 
TYPE= 
TYPE= 
TYPE= 
TYPE= 
TYPE= 
TYPE= 
TYPE= 
TYPE= 
TYPE= 
TYPE= 
TYPE= 
TYPE= 
TYPE= 


DOMAIN TYPE= MAJOR NODES 


APPL SEGMENT 
APPL SEGMENT 

APPL SEGMENT 
APPL SEGMENT 
APPL SEGMENT 
APPL SEGMENT 

APPL SEGMENT 
CDRSC SEGMENT 
CDORSC SEGMENT 
CORSC SEGMENT 
CDRSC SEGMENT 

LCL 3270 MAJ NODE 
LCL 3270 MAJ NODE 
LCL 3270 MAJ NODE 
LCL 3270 MAJ NODE 
NCP MAJOR NODE 
CDRSC SEGMENT 
CDRM SEGMENT 


COMMAND LIST MAJNODES COMPLETE 


LOOK AT NCCFZ'S CDORMS. 


CLIST "CDRMS" is being used. 


14:38:57 C ROUTE NCCFZ,CDRMS 
14:39:08 * CDRMS 
14:39:16 C DISPLAY 


14:39:24 
14:39:24 
14:39:24 
14:39:24 
14:39:24 
14:39:24 


ISTO97I 
IST3501 
ISTO89I 
IST482I 
IST4¢82I 
IST482I 


NET,CDRMS, EVERY 


DISPLAY ACCEPTED 
VTAM DISPLAY - DOMAIN TYPE= CROSS-DOM. RSRC MGR 


CDORNZ TYPE= CDRM SEGMENT 

LSSCMVS2 ACTIV ,SUBAREA = 032 
LSSCMVS1 ACTIV ,SUBAREA = 031 
TOROMVSV ACTIV ,SUBAREA = 001 


» ACTIV 
» ACTIV 
» ACTIV 
» ACTIV 
» ACTIV 
» ACTIV 
» ACTIV 
» ACTIV 
» ACTIV 
» ACTIV 
» ACTIV 
» ACTIV 
» ACTIV 
» ACTIV 
» ACTIV 
» ACTIV 
» ACTIV 
» ACTIV 


» ACTIV 


»CUA=505 


NCCFZ 
NCCFZ 


NCCFL 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 

.CCFZ 
NCCFZ 
NCCFZ 


NCCFL 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
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14:39:24 
14:39:24 


14:40:09 
14:40:07 
14:40:10 
14:40:12 
14:40:12 
14:40:12 
14:40:12 
14:40:12 
14:40:12 
14:40:12 
14:40:12 
14:40:12 
14:40:15 
14:40:16 


14:42:49 
14:42:55 
14:43:01 
14:43:04 
14:43:04 
14:43:04 
14:43:04 
14:43:04 
14:43:04 
14:43:05 
14:43:05 
14:43:05 
14:43:05 
14:43:05 
14:43:10 
14:43:16 
14:43:10 
14:43:11 
14:43:11 
14:43:11 
14:43:30 


IST482I TORORTT NEVAC ,SUBAREA = 012 
IST314I END 
| Displaying the CDRM segment CDRMZ. | 

C ROUTE NCCFZ,DIS CDRMZ 
* DIS CDRMZ 
C Enter: ST or STATUS xxxxx(xxxxx) for status description 
C DISPLAY NET,ID=CDORMNZ>E 
C DSIO13I COMMAND LIST DIS COMPLETE 

ISTO97I DISPLAY ACCEPTED 

ISTO75I VTAM DISPLAY - NODE TYPE= CBDRM SEGMENT 

IST486I NAME = CDRMZ » STATUS = ACTIV 

IST477I CDBRMS: 

IST482I LSSCMVS2 ACTIV ,SUBAREA = 032 

IST482I LSSCMVS1 ACTIV ,SUBAREA = 631 

IST482I TOROMVSV ACTIV ,SUBAREA = 001 

IST4682I TORORTT WNEVAC ,SUBAREA = 012 

IST314I END 

Look at the terminals in domain NCCFZ 
(cross-domain). 

C ROUTE NCCFZ,TERMS 


* TERMS 

C DISPLAY NET,TERMS, 
ISTO97I DISPLAY ACCEPTED 
IST350I VTAM DISPLAY - DOMAIN TYPE= LOGICAL UNITS/TERMS 
IST351I LOCAL 3270 MAJOR NODE: NAME = ZLOCALO2 
ISTOS9I LSZ020 TYPE= LOGICAL UNIT » ACTIV »CUA=020 
ISTO89I LSZ621 TYPE= LOGICAL UNIT » ACTIV »CUA=021 
ISTO089I LSZO022 TYPE= LOGICAL UNIT » NEVAC »CUA=022 
ISTO89I LSZ023 TYPE= LOGICAL UNIT » ACTIV »CUA=023 
ISTO89I LSZ024 TYPE= LOGICAL UNIT » ACTIV »>CUA=024 
ISTO89I LSZ025 TYFE= LOGICAL UNIT » ACTIV »CUA=025 
ISTO89I LSZ026 TYPE= LOGICAL UNIT » ACTIV »>CUA=026 


ISTO89I LSZ027 TYPE= LOGICAL UNIT » NEVAC »>CUA=027 
IST351I LOCAL 3270 MAJOR NODE: NAME = ZLOCALO3 

ISTC89I LSZ030 TYPE= LOGICAL UNIT » ACTIV »CUA=030 
ISTO89I LSZ031 TYPE= LOGICAL UNIT » ACTIV »>CUA=031 
ISTC89I LSZO32 TYPE= LOGICAL UNIT » ACTIV »CUA=032 
ISTO89I LSZ033 TYPE= LOGICAL UNIT » ACTIV »CUA=033 


ISTO89I LSZ034 TYPE= LOGICAL UNIT » ACTIV » CUA=034 
IST351I LOCAL 3270 MAJOR NODE: NAME = ZLOCALOD 
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NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 


NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 


~ NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 


14:43:30 
14:43:31 
14:43: 34 
14:43:36 
14:43:36 
14:43:36 
14:43:36 
14:43:36 
14:43:36 


14:44:36 
14:44:36 
14394: 36 
14:44:36 


14:44:37 
14:44:37 


14:44:37 
14:44:37 
14:44:37 
14:44:37 
14:44:37 
14:44:37 
14:44:37 


14:46:55 
14:96:55 
14:46:55 
14:46:56 
14:46:56 
14:46:56 
14:46:56 
14:46:56 
14:46:56 


Cc 


Oana x 


* 


Cc 
C 


ISTO89I 
ISTO89I 
IST3541 
IST1IG61 
IST3591 
IST1461 
IST3591 
IST3141 
DSIO13I 


COMMAND LIST TERMS 
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LSZODO0) 3 =TYPE= LOGICAL UNIT » ACTIV 
LSZOD1 TYPE= LOGICAL UNIT » ACTIV 
NCP MAJOR NODE: NAME = N37R21 = ,CUA=505 
LINE NAME: L370B0 STATUS: ACTIV 
ATTACHMENT = LEASED 

LINE NAME: L37DUMMY STATUS: NEVAC 


ATTACHMENT = LEASED 
END 
COMPLETE 


Display a specific terminal in the home-domain. 


DIS LU360263 
Enter: ST or STATUS xxxxx(xxxxx) for status description 


DISPLAY 
DSTO1L3I 
ISTO/751 
IST486I 
ISTO81I 
IST1351I 
IST6751 
IST314¢1 
IST0sel 


e 


« 


NET , ID=LU360263,E 
COMMAND LIST DIS COMPLETE 

VTAM DISPLAY - NODE TYPE= LOGICAL UNIT 
NAME= LU360263 ,»STATUS= ACT/S 

LINE NAME= L36026 » LINE GROUP= G36S2 
PHYSICAL UNIT= PU36026_ ,; 

VR = 0, TP= 60 

END 


The device type is LU. 
It 1s in session with LTSO0003. 
The assigned application 1s LNETMON. 


DTSO LS86584¢ 


DISPLAY 
DSIO131 
ISTO75I 
IST486I 
IST5761 
IST262I 
IST262I 
IST314I 


NET>,U,ID=LS86584¢ 
COMMAND LIST DTSO 


COMPLETE 

VTAM DISPLAY ~- NODE TYPE= TSO USERID 
NAME= LS86584 ;,STATUS= ACTIV 

TSO TRACE=OFF 

APPLNAME = TSO00003 
LUNAME = 

END 


» STATUS 
LU360263 , STATUS 


ACTIV 
ACT/S 


» CUA=0D0 
»CUA=0D1 


»DESIRED STATE= ACTIV 
» MAJNOD= N36R21 


Display a TSO user ID in the home-domain. 


»DESIRED STATE= N/A 


NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 
NCCFL 


NCCFL 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
NCCFZ 
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14:49:55 
14:49:55 
14:49:56 
14:49:56 
14:49:56 
14:49:56 
14:49:56 
14:49:56 
14:99:56 
14:49:56 


15:08:37 
15:08:45 
15:08:46 
15:08:46 
15:08:51 
15:08:51 
15:08:51 
15:08:51 
15:08:51 
15:08:51 
15:08:51 
15:08:51 
15:08:54 
15:08:54 
15:08:54 


Cc 


Displaying Terminal LU360260 


Note: 
LNETMON 1s the controlling application 


it is in the home-domain ("L'') 
ZTSO is the cross-domain ("'Z'') application 
the terminal is allocated to 


D NET>E,ID=LU360260 


DSIOIL3I 
ISTO751 
IST4861 
ISTO81I 
IST1351 
IST3141I 
ISTO082.I 


e 


COMMAND LIST PD 


COMPLETE 
VTAM DISPLAY - NODE TYPE= LOGICAL UNIT 
NAME= LU360260 ,STATUS= ACT/S 
LINE NAME= L36026 » LINE GROUP= 63652 


»DESIRED STATE= ACTIV 
» MAJNOD= N36R21 


PHYSICAL UNIT= PU36026 =, 

END 

The device type is LU. 

It is in session with ZTSO. 

The assigned application is LNETMON. 


ROUTE NCCFZ,DIS ZTSO0001 

DIS ZTSOCOO!L 

Enter: ST or STATUS xxxxx(xxxxx) for status description 
DISPLAY NET,ID=ZTSOO001,E 


ISTO97I 
ISTO751 
IST4861 
IST2le2.I 
IST6541 
Ist2711I 
IST1711 
IST2061 
IST6341 
IST6351 
IST3141 


DISPLAY ACCEPTED 

VTAM DISPLAY - NODE TYPE= APPL 

NAME = ZTSO0O001 , STATUS = ACTIV 
ACBNAME = TSOCOO0O] 

I/O TRACE= OFF ,BUFFER TRACE= OFF 
JOBNAME = TEAMO2 STEPNAME = LSSCUSER 
ACTIVE SESSIONS = 0001 SESSION REQUESTS = 0000 
SESSIONS: 

NAME STATUS SESS ID SEND RECV 
LU360260 ACTIV-SEC %0064813 0017 0002 
END 
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EXAMPLE 4: NCCF LOG PRINTOUT 


ACF/SNA SYSTEM PROBLEM DETERMINATION GUIDE Vol. I 


Note: Comments can be written into the 
log in the form of invalid commands. 


The home-domain is NCCFL. 
The other domain is NCCFZ. 


Example of an NCCF log printout showing 
excerpts from a cross-domain session. 
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14:34:25 * ===== WHO IS ON NCCFZ 2227? 

14:34:25 - DSIOO2I INVALID COMMAND 
14:34:37 * PG WHO 
14:34:38 C ROUTE NCCFZ,WHO 
14:34:38 C DSIO13I COMMAND LIST P4 COMPLETE 

NCCFZ 14:34:51 * WHO 
14:34:58 C ===> THESE HOME-DOMAIN OPERATORS ARE LOGGED ON <== 
14235701 C ss ee % % 
14:35:01 C ......YV 
14:35:01 - OPERATOR: BILL TERM: LSZ020 STATUS: ACTIVE 
14:35:01 - END OF STATUS DISPLAY 
14:35:01 C ===> THESE CROSS-DOMAIN OPERATORS ARE LOGGED ON <== 
14:35:01 C ....../1 
1423520! Cow we we aw eV 
14:35:05 - MAX SESS: 00000008 
14:35:05 - OPERATOR: HEINZ TERM: NCCFLOOO STATUS: ACTIVE 
14:35:05 - END OF STATUS DISPLAY 

NCCFL 14:35:34 * ==== WHAT ARE NCCFZ MAJNODES 2722? 
14:35:34 - DSIO002I INVALID COMMAND 
14:35:44 * PG MAJNODES 
14:35:44 C ROUTE NCCFZ,MAJNODES 
14:35:45 C DSIO13I COMMAND LIST P4 COMPLETE 

NCCFZ 14:36:03 * MAJNODES 
14:36:06 C DSI209I COMMAND LIST MAJNODES WARNING - INVALID COMMAND ENCOUNTERED - COMMAND 

IGNORED 
14:36:06 C K 
14:36:06 C DISPLAY NET,MAJNODES 
14:36:10  ISTO97I DISPLAY ACCEPTED 
14:36:10  IST350I VTAM DISPLAY - DOMAIN TYPE= MAJOR NODES 
14:36:10 ISTO89I VTAMSEG TYPE= APPL SEGMENT » ACTIV 
14:36:10  $ISTO89SI ZATSO TYPE= APPL SEGMENT » ACTIV 
1 NETWORK COMMUNICATIONS CONTROL FACILITY PRINT LOG UTILITY 

14:36:10 ISTO89I ZATSOP TYPE= APPL SEGMENT » ACTIV 


OHEINZ 
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NCCFZ 


NCCFL 


NCCFZ 


NCCFL 


NCCFZ 


14:36:10 
14:36:13 
14:36:13 
14:36:13 
14:36:13 
14:36:13 
14:36:17 
14;3:36:17 
14:36:17 
14:36:17 
14:36:17 
14:36:41 
14:36:41 
14:36:41 
14:36:41 
14:36:41 
14:37:07 
14:37:07 
14:37:07 
14:37:07 
14:37:07 
14:37:08 
14:37:08 
14:37:08 
14:37:08 
14:37:08 
14:37:11 
14:37:11 
14:37:11 
14:37:11 
14:37:11 
14:37:14 
14:37:50 
14:37:51 
14:38:56 
14:38:57 
14:38:57 
14:39:08 
14:39:16 
14:39:24 
14:39:24 


14:39:24 


14:39:24 
14:39:24 
14:39:24 
14:39:24 
14:39:24 
14:39:59 


14:40:00 C DSIO13I COMMAND LIST P4 
NETWORK COMMUNICATIONS CONTROL FACILITY PRINT LOG UTILITY 


* 


ISTO89I 
ISTO89I 
ISTO891 
ISTO89I 
ISTO89I 
ISTO89I 
ISTO89I 
ISTO89I 
ISTO89I 
ISTO89I 
ISTO89I 
ISTO89I 
ISTO89I 
ISTO89I 
ISTO89I 
ISTO89I 
ISTO89I 
ISTO89I 
ISTO89I 
ISTO89I 
ISTOS9I 
ISTO89I 
ISTO89I 
ISTO89I 
ISTO89I 
ISTO89I 
ISTO89TI 
ISTO89I 
ISTOS89I 
ISTO891I 
IST3141 
DSIOL3I 


ZACICS 
ZAIMS 
ZAIIS 
ZAVSPC 
ZANSOL 
ZADDP 
ZANCCF 
ZAJES 
CDRSCHAD 
CDRSCHAI 
CDRSCHA2 
CDRSCHA3 
CDRSCLAO 
CDRSCLAI 
CDRSCLA2 
CDRSCRAO 
CDRSCRAI 
ZLOCALO2 
ZLOCALO3 
ZLOCALO06 
ZLOCALO7 
ZLOCALOC 
ZLOCALOD 
ZCONSOLE 
N37R21 
CDRSCHLO 
CDRSCLLO 
CDRSCLLI 
CDORSCRLO 
CDRMZ 
END 


TYPE= 
TYPE= 
TYPE= 
TYPE= 
TYPE= 
TYPE= 
TYPE= 
TYPE= 
TYPE= 
TYPE= 
TYPE= 
TYPE= 
TYPE= 
TYPE= 
TYPE= 
TYPE= 
TYPE= 
TYPE= 
TYPE= 
TYPE= 
TYPE= 
TYPE= 
TYPE= 
TYPE= 
TYPE= 
TYPE= 
TYPE= 
TYPE= 
TYPE= 
TYPE= 


DSIOO02I INVALID COMMAND 
P4 CORMS 
ROUTE NCCFZ,CORMS 


DSIO13I 
CORMS 


DISPLAY NET,CDRMS, EVERY 


ISTO97I 
IST3501 
ISTO89I 
IST4821I 


~IST4¢82I 


IST¢8elI 
IST4821 
IST3141 


COMMAND LIST P4 


APPL 
APPL 
APPL 
APPL 
APPL 
APPL 
APPL 
APPL 
CDRSC 
CORSC 
CORSC 
CDRSC 
CDRSC 
CORSC 
CDRSC 
CDRSC 
CDRSC 


SEGMENT 
SEGMENT 
SEGMENT 
SEGMENT 
SEGMENT 
SEGMENT 
SEGMENT 
SEGMENT 
SEGMENT 
SEGMENT 
SEGMENT 
SEGMENT 
SEGMENT 
SEGMENT 
SEGMENT 
SEGNENT 
SEGMENT 


LCL 3270 
LCL 3270 
LCL 3270 
LCL 3270 
LCL 3270 
LCL 3270 
LCL 3270 


MAJ 
MAJ 
MAJ 
MAJ 
MAJ 
MAJ 
MAJ 


NODE 
NODE 
NODE 
NODE 
NODE 
NCDE 
NODE 


NCP MAJOR NODE 
CDORSC SEGMENT 
CDRSC SEGMENT 
CDRSC SEGMENT 
CDRSC SEGMENT 


CDRM SEGMENT 


COMMAND LIST MAJNODES COMPLETE 
=== LOOK AT NCCFZ'S CDRMS (CDRNZ) 


COMPLETE 


DISPLAY ACCEPTED 
VTAM DISPLAY - 


CDORMZ 


LSSCMVS2 ACTIV 
LSSCMVS1 ACTIV 
TCROMVSV ACTIV 
TORORTT NEVAC 


END 


PG DIS CDRMZ 
14:40:00 C ROUTE NCCFZ,DIS CDRNZ 


14:40:07 * DIS CDRMZ 


TYPE= 


» ACTIV 
» ACTIV 
» ACTIV 
» ACTIV 
» ACTIV 
» ACTIV 
» ACTIV 
» ACTIV 
» ACTIV 
» ACTIV 
» ACTIV 
» ACTIV 
» ACTIV 
» ACTIV 
» ACTIV 
» ACTIV 
» ACTIV 
» ACTIV 
» ACTIV 
» ACTIV 
» ACTIV 
» ACTIV 
» ACTIV 
» ACTIV 
» ACTIV 
» ACTIV 
» ACTIV 
» ACTIV 
» ACTIV 
» ACTIV 


»CUA=505 


DOMAIN TYPE= CROSS-DOM. RSRC MGR 


CDRM SEGMENT 
»SUBAREA = 032 
»SUBAREA = 031 
»SUBAREA = 001 
» SUBAREA = 012 
COMPLETE 
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NCCFL 
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14:40:10 C Enter: ST or STATUS xxxxx(xxxxx) for status description 
14:40:12 C DISPLAY 
14:40:12 C DSIOL3I 


14:40:12 
14:40:12 
14:40:12 
14:40:12 
14:40:12 
14:40:12 
14:40:12 
14:40:15 
14:40:16 


14:41:49 * 


ISTO97I 
ISTO75I 
IST4861 
IST¢771 
IST482I 
IST482I 
IST482I 
IST4¢82I 
IST3141 


NET, ID=CDRMZ,>E 

COMMAND LIST DIS COMPLETE 

DISPLAY ACCEPTED 

VTAM DISPLAY - NODE TYPE= CDRM SEGMENT 
NAME = CDRNZ » STATUS = ACTIV 
CDRMS: 


LSSCMVS2 ACTIV ,SUBAREA = 032 
LSSCMVS1 ACTIV ,SUBAREA = 031 
TOROMVSV ACTIV ,SUBAREA = 001 
TORORTT NEVAC ,SUBAREA = 012 


END 


==== KHAT TERMINALS 2??? 
14:41:49 - DSI002I INVALID COMMAND 
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4.2.2 3: NETWORK MANAGEMENT PRODUCTIVITY FACILITY 
CNMPE } 


DESCRIPTION 


Network Management Productivity Facility (NMPF) is 
intended to help network systems and operations person- 
nel install, learn, and productively use many of IBM's 
systems and network management products (NCCF, NPDA, 
NLOM, NPA, OCCF, Info/Mgmt, TAF, VNCA, TARA, SOF, and 
HCF}. It is built on NCCF and uses standard command 
lists (CLISTS}, command processor, and user exit func- 
tions. 

NHPF contains: 

® tutorials 

® HELP facilities 

@ operational scenarios 

° sample databases 


® sample procedures for the Systems/Network Manage- 
ment products 


Other functions provided by NMPF enable the NCCF opera- 
tor to: 


® Interpret VTAM sense codes and status modifiers 
online. 


@ Browse NCCF and VTAM definitions online. 
® Display NCCF control blocks. 

¢ Display MVS storage. 

® Assign PF Keys dynamically. 

NMPF contains the following components: 


e Job streams to aid in installing and customizing 
System/Network management (S/NM) programs. 


@ NCCF, OCCF, and SOF CLISTs. 
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® NCCF definitions for S/NM programs that require 
them. 


bd NCCF command processors and exit routines. 


® Sample databases for NPDA, NLDM, TARA, NPA, and 
Info/Mgymt. 


e Sample VTAM definitions. 

The personnel most likely to use NMPF are those who: 
e Are not familiar with NCCF. 

° Require an introduction to S/NM products. 

© Are network operators requiring assistance. 


¢ Are responsible for problem determination and need 
to know what techniques are available to help them. 


AVAILABILITY 


IBM Program Product 5798-DPC. 


PRODUCT DEPENDENCIES 


® NCCF Rel. 2 
e VSAM 


° ACF/VTAM 


REFERENCE MANUALS 


® Network Management Productivity Facility Program 
Description and Operation Manual (SH20-0038). 
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OPERATION The NMPF tutorials are presented using standard NCCF 


features, complemented with NMPF command processors, 
NMPF can be available to all NCCF users whether local, CLISTs and panels. A command for an NCCF based S/NM 


remote, or in another domain. program may be entered directly from the tutorial 
screen, while the tutorial continues to provide guid- 


The online menu-driven tutorials provided by NMPF ance. 

should help with most of the problems encountered dur- 

ing normal operations and make the initial educat. n The NMPF tutorials can be invoked immediately after 
process easier. They remain accessible and can be having Signed-on to  NCCF (see Example 1}. 


recalled whenever additional assistance is required. Alternatively, to enter the NMPF tutorials at any time 


from NCCF, enter 'NMPF' on the NCCF panel. 


EXAMPLE 1: INVOKING NMPF 


The following example shows how to invoke NMPF immediately after having signed-on to NCCF. 


FSMNOTES NETWORK MANAGEMENT PRODUCTIVITY FACILITY (NMPF) 
| 5798-BDPC COPYRIGHT IBM CORP. 1983 


HRKKHKKHX SYSTEM NEWS HHKKHKHKHK KK Enter 't' for tutorial mode. 


07/04/83 Network Management Productivity Facility installed. 
Please notify operations support if any problems. 


t Enter T for tutortal mode, Enter H for help, or PF3: 


The resulting panel is shown next. 


TUTMENU NETWORK MANAGEMENT PRODUCTIVITY FACILITY (NMPF ) 
5798-DPC COPYRIGHT IBM CORP. 1983 
SELECTION CONTENTS 


A general overview of NMPF 

HELP facilities in NMPF 

How to use PFKs in NMPF 
show VTAM CLISTs and commands Main menu for tutorials. 
show the format of NCCF commands From here, simply follow 
show what OCCF is and how to use 1 the menu-driven tutorial 
show what TAF is and how to use 1 through the desired path. 
show what NPDA is and how to use 1 
show what NLDM is and how to use 1 
show what TARA is and how to use i 
show what HCF is and how to use it 
show what VNCA is and how to use it 
show what INFO/MANAGEMENT is and how to use it 

SCENARIOS To demonstrate different operational scenarios 


Select an option, or press ENTER to display more options. 


OPTION ===> PFi= HELP 3= RETURN 8/ENTER= NEXT PAGE 
TO NCCF (PF9) 
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Operators may forget the syntax of a command or the correct meaning of an operand. NMPF provides 
many CLISTs for HELP in different products. 


The HELP facilities can be accessed at different levels: 


1. HELP XXXX or XXXX PFKI 


gives a general scope of the products or CLIST commands Cin this case XXXX). See Example 2. 


2. HELP XXXX COMMAND or HELP XXXX CLIST 
XXXX COMMAND PFKI or XXXX CLIST PFKI 


gives a list of all the commands and/or CLISTs for every CNM Product. XXXX can be VTAM, NCCF, NPDA, 
NLOM, OCCF, TAF, TARA», VCNA or Info/Momt. 


EXAMPLE 2: USING THE ‘HELP’ FACILITY 


The following example shows the screen that results after having typed ‘HELP VTAM' on the NCCF 
panel. 


TUCLIVTA NETWORK MANAGEMENT PRODUCTIVITY FACILITY (NMPF) 
5798-DPC COPYRIGHT IBM CORP. 1983 
ONLINE VTAM COMMANDS AND CLISTs 


CLISTs Alphabetical list of available NCCF CLISTs 


DISPLAY VTAM DISPLAY command 
CLISTs: APPLS,BFRS,BFRUSE,CDRMS,CDRSCS,CLSTRS; From this panel we can 
DRDS,NODE,LINES,MAJNODES,NCPSTOR, PATHS, select one of the s1x 
PATHTAB,; PENDING,DROUTE,STATIONS, TERMS,DTSO options for the desired 


information. 
VARY VTAM VARY command 


CLISTs: ACQ,ACT,DRDS,INACT,INOP,REL,VTERM 
MODIFY VTAM MODIFY command 
CLISTs: DYNA,LL2,NOVTAMI,NOSTAT»,STATS; TNSTAT> 
TRACE, TRLINE»,VTAMI 
START/STOP VTAM command 
6. REPLY VTAM command 


OPTION ===> PF3= RETURN 4= MENU 
TO NCCF (PF9) ===> 
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The HELPDESK facility helps the operator follow through the logic of problem determination via a 
menu-driven system, and then suggests a course of action. 


To invoke the HELPDESK facility of NMPF, enter HELPDESK on the NCCF panel, then select the appropri- 
ate options (example 3). 


EXAMPLE 3: USING THE 'HELPDESK"' FACILITY 


The following example shows a sample path taken through the NMPF HELPDESK facility. 


NETWORK MANAGEMENT PRODUCTIVITY FACILITY (NMPF) 
5798-DPC COPYRIGHT IBM CORP. 1983 
ON-LINE GUIDANCE IN PROBLEM DETERMINATION 


| HPDMENU 


HH HH EEEEEEEE LL PPPPP DDDDD EEEEEEEE SSSSSS KK KK 

HH HH EEEEEEEE LL PP PPP DD ODD EEEEEEEE $$ KK KK 

HH HH EE LL PP PP 0D DD EE $s KK KK 

HH HH EE LL PP PP DD DD EE $s KK KK 

RHHHHHHHH EEEEEEEE LL PP PPP DD DD EEEEEEEE SSSSS KKKK 

HHHHHHHH EEEEEEEE LL PPPPP DD DD EEEEEEEE SSSSS KKKK 

RH HH EE LL PP DD DD EE SS KK KK The end user is complaining 
HH HH EE LL PP DDB)6DD: CEE: SS KK KK about bad response times. 
HH HH EEEEEEEE LLLLLLLL PP DD BD EEEEEEEE SS KK KK (Option 3) 


EEEEEEEE LLLLLLLL PP DODDD EEEEEEEE SSSSSS 


alae toa ach Select one of the following options -------------------- 


1. OPERATIONAL PROBLEN 
2. APPLICATION PROBLEM 


An end user cannot get his terminal to work. 
An end user cannot run a certain transaction/appl. 


3. BAD RESPONSE TIME = An end user complains about bad response times. 
4. HARDWARE PROBLEM - A hardware problem is reported 
5. SYSTEM MESSAGES - A system message indicates a problem 


SELECT OPTION ===> 3 PFl: 


HELP PF3: END PF4: MENU PF9: TO/FROM NCCF 


| HPDPERF PERFORMANCE PROBLEMS 
 perescaceede Actions at this stage. For more information press PFl. ------- ——— 


1. Record the call in the phone log - userid, address, phone number and 
error code. 

2. The purpose of the following action is mainly to collect documentation 
and to check if the problem is a performance problem. 

3. Go to next panel depending on how the terminay is connected. 


(pais iincst ada ccaieaatmenmatoe Now select one of the following options --------------------- 
1. 3270 - The terminal is connected to a 3274 controller. 
2. 3600 - The terminal is connected to a 3600 system. 
3. 8100 - The terminal is connected to a 8100 system. 

SELECT OPTION ===> 1 PFl: HELP PF3: END PF4: MENU PF9: TO/FROM NCCF 


HPDP3274 3270 USERS COMPLAIN ABOUT BAD RESPONSE TIMES 
Actions at this stage. For more information press PFl. 


Try to isolate the problem through questions to the end-user about when 
he has the bad response times. 


Calculate the end-user's response times through the information in NLDM 
The HELP panel gives an example. 


Select one of the following options 


NETWORK - Investigation of performance in the network 
HOST - Investigation of performance in the host 
SUBSYSTEM - Investigation of performance in the subsystem 


SELECT OPTION ===> 1] PFl: HELP PF3: END PF4: MENU PF9: TO/FROM NCCF 


NOCF COMMAND > 
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The terminal suffering bad 
response times 1s connected 
to a 3274 controller. 
(Option 1) 


Suspect the problem is in 
the network. 
(Option 1) 
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HPDPNETW INVESTIGATION OF PERFORMANCE IN THE NETWORK 


Actions at this stage. For more information press PFl. 


1. Investigate the number of retransmissions through NPDA MR ST N puname 
and, if the rate is high, the counters in the 3274 NPDA CTRL puname SEC. 

2. Start either NPA data collection (NPA option 2) or monitoring function NMPF suggested actions. 
(NPA option 3) the resources in the network that the end-user utilizes, 
if they are not started. 


In that case go and inspect the collected data or the warnings that NPA 
has issued (NPA option 7). That might explain the bad response times. 
Report the call to the capacity planner, and bring along the NPA data 
as documentation. 


PFl: HELP PF3: END PF4: MENU PF9: TO/FROM NCCF 


Most of the licensed programs supported by NMPF provide 
extensive opportunities for customization. NMPF sup- 
plies a ‘starter’ set, which each user may wish to cus- 
tomize further in accordance with installation-specific 
requirements. For example, default names can be 
changed, CLISTs can be addad, and the full-screen tuto- 
rial can be customized dynamically. 


The "BROWSE' facility in NMPF allows users to browse 
NCCF and VTAMLST members. This feature can be helpful 
in dealing with problems related to such things as the 
definition of a VTAM resource, the sequence of the 
statements in a CLIST, or the content of any member 
used by NCCF. The implementation of the browse command 
is similar to the browse option of Systems Productivity 
Facility (SPF). Standard NCCF security features are 


GG24-1514-1 


used to ensure that the installation has control over 
the operator's authority to view the data. 


The 'SHOW' command 1s a working version of a sample 
program (DSIUSP) documented in NCCF Customization 
(SC27-0433). This command processor allows any author- 
ized operator to examine NCCF control blocks and MVS 
storage. It is useful for debugging user-written exits 
and command processors. 


Finally, the NMPF installation procedure documents a 
way to run two copies of NCCF in the same VTAM domain. 
This provides the ability to have both a test (Cor 
training) version and a production version on the same 
system. It also allows for the simulation of multisys- 
tem networking. 
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4.2.3 : NPDA 


DESCRIPTION 


NPDA (a program product) was the first IBM tool based 
on NCCF. It relies on the fact that most of the IBM 
hardware or software monitors itself and its sur- 
roundings. The 3705/3725 and the NCP both monitor com- 
ponents in the 3705/3725 and they monitor also the line 
as far as possible - this means to the local modem, if 
LPDA Cintroduced with ACF/NCP Version 1 Release 2.1) is 
not used. If LPDA is used, however, not only the remote 
modem, but also the PU behind the remote modem can be 
monitored to some extent. If a component becomes unus- 
able, NCP reports what is wrong by sending a record to 
the access methods, which have a session with the NCP. 
The NCP also reports when it has lost contact with a 
PU, and will at the same time send all counters associ- 
ated with the PU to the access method. The software 
will also send a record if an error counter reaches its 
maximum and is about to wrap around. The cluster con- 
trollers in the network behave in a similar way. 


The central hardware has sent the same Kind of records 
to the system log for many years. The records are made 
available to the CE through a batch system (EREP). From 
the reports, the CE Knows when a disk is about to cre- 
ate problems. These records are also sent to NPDA, and 
NPDA is, therefore, able to inform the network operator 
about difficulties with a disk or another local device. 


Commands 


NFPDA is an NCCF command and can be controlled with a 
set of subcommands. Since retrieval of maintenance 
data stored in its datasets is one of the most fre- 
quently performed functions, the required search argu- 
ments can be used by responding to a series of 
prompting screens presented to the user. 


Dataset 


NPDA has one VSAM dataset (KSDS organization in which 
error data is Kept. 
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FEATURES 


NPDA is invoked by NCCF in response to the NFDA 
command, no separate logon 1s required. It can be 
operated by responding to full-screen menus, or by 
issuing explicit commands. Responding to menu prompting 
permits interactive, structured browsing of the error 
information starting at a summary level and continuing 
to a detail level. 


If a cross-domain NCCF to NCCF session is in progress, 
NPDA can extract error information from the SNA data- 
base of the NPDA in the other domain for viewing in the 
home-domain. 


NPDA introduces five major types of transactions which 
can be regarded as an extension to NCCF. Thay: 


- Retrieve data from the system either through a 
direct operator command, or indirectly as a 
result of something happening in the network 
and store it in the database, if specified. 


- S§tore unsolicited records generated by the sys- 
tem in the database, if specified. 


- Generate an alert if certain specified condi- 
tions are met. 


~- Display the data in a readable format on a 
screen. 


- Set and allow the different parameters control- 
ling NPDA to change. 


AVAILABILITY 


P/P 5668-920 (Current release: Version 3 for MVS). 
P/P 5666-295 (Current release: Version 3 for DOS/VSE). 
NOTE: While there are earlier versions and releases 


available, Version 3 should be used because it contains 
more. 


PRODUCT DEPENDENCIES 


® NCCF Release 2 or Version 2 


@ ACF/VTAM Cor ACF/TCAM) 
®@ ACF/NCP 


e VSAM 


REFERENCE MANUALS 


e NPDA General Info .. 
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- 6034-2111 


NPDA Installation . . . SC34-2117 
NPDA Messages ... . . SC34-2115 


NPDA Recommended 
Action Guide S$C34-2113 


NPDA User Reference . . SC34-2114 


NPDA Diagnosis .. . . $€34-2130 
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OPERATION - Errors or exception conditions detected by an 
NCP 


- Solicited errors/statistics requested from a PU 
MESSAGE FLOW FOR DATA COLLECTION 
- Unsolicited errors/statistics sent by a PU 


The following main areas are covered as follows: 


ERRORS DETECTED BY AN NCP 


Figure 5. Message Flow of NCP—detected Errors 


In Figure 5 the flow for NCP-detected errors or excep- 
tion conditions is shown. The NCP uses for this purpose 
the SNA Command 'RECMS', which it sends to the SSCP. 
This is indicated by (1). 


It should be pointed out that the NCP sends the infor- 
mation regarding a PU to the host (SSCP) which owns the 
PU. A PU can be owned by only one host, whereas a line 
can have up to 8 owners, which means that the NCP can 
send information related to a line to as many as 8 
hosts (SSCPs). 


The SSCP then sends this information via the CNM inter- 
face to the NPDA. This is indicated by (2) and the SSCP 
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uses for this purpose the 'DELIVER'-Command, which con- 
tains the original 'RECMS'. 


It should be mentioned here that the VTAM module 
‘ISTMGCOO' (for MVS) defines the name of the VTAM 
application to which VTAM has to deliver the 'RECKS' 
and 'RECFMS' commands (over the CNM interface). This 
application is normally called 'BNJDSERV' and has to be 
defined as a VTAM APPL with 'AUTH=CNM'. Further infor- 
mation can be found in the NPDA Version 3 Installation 
Manual (C34-2117) or in the SNA Installation Guide 
(GG24-1557). 
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NPDA stores the information received on its active 
dataset as event, and possibly,» as alert data. This is 
shown as (3). 


SOLICITED ERRORS/STATISTICS FROM A PU 


Figure 6. Message Flow for soliciting error stats from a PU 


In Figure 6 the flow for soliciting errors or statis- 
tics stored in a PU is shown. The response from the PU 
can be seen in the next figure, together with the unso- 
licited errors or statistics sent by a PU. 


If NPDA wants to have this information it sends the 
request over the CNM interface to the SSCP in the form 
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of a 'FORWARD' command, which contains the 'REQMS' com- 
mand. This can be seen under (1). 


The SSCP then sends the 'REQMS' command (Request for 
Maintenance Statistics) to the specified PU. This is 
shown under (2). 
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UNSOLICITED ERRORS/STATISTICS SENT BY A PU 
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Figure 7. Message Flow of PU sending error stats unsolicited 


Figure 7 shows both the message flow of a PU answering 
to a solicitation for the accumulated error statistics 
as well as sending these informations unsolicited under 
certain circumstances. 


The PU does this by sending the 'RECFMS' command (RE- 
Cord Formatted Maintenance Statistics) to the SSCP. 
This is shown under (1). In the case of unsolicited 
error statistics, the 'RECFNS' ts always a ‘type 0 
RECFNS'. For the solicited error statistics there are 
types 1 through 5. 


The SSCP then sends this information via the CNM inter- 
face to NPDA. This is indicated by (2) and the SSCP 
uses for this purpose the 'DELIVER' command, which con- 
tains the original 'RECFMS'. 


The SSCP uses the CNM interface to deliver the ‘RECFMS' 
command in much the same way as for the ‘'RECNS' 
command, which has been explained and discussed before. 


NPDA then stores the information received on its active 
dataset as event or statistics information. This is 
shown as (3}. 


MESSAGE FLOW FOR DATA RETRIEVAL SINGLE DOMAIN 


NPDA < >} Operator 
Display < >} Station 


Data 
Services 
Task 


Figure 8. Single Domain Data Flow for NPDA Data Retrieval 


G624-1514-1] TOOLS/SERVICE AIDS 


PAGE 4-61 


6G624-1514-1 


CROSS-DOMAIN 


NPDA < >} Operator 
Display [|<—}->]| Station 


Data 
Services 
Task 


| Figure 9. Cross-Domain Data Flow for NPDA Data Retrieval 


Retrieval of NPDA data from another network domain can 
be accomplished, provided both systems are running 
under the same version and release of NPDA. In Figure 9 
the data flow between the NPDA/NCCF facilities con- 
tained within two separate network domains is depicted. 
The NPDA user invokes this function by executing the 
SDOMAIN command, subsequent to an NCCF START DOMAIN 
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command, indicating the domain where he/she wishes to 
view NPDA data. 


Cross-domain requests sent by the native domain OST are 
directed to an NCCF to NCCF task (NNT) in the foreign 
domain. Control is then passed to the data service 
task, which retrieves NPDA data from its database and 


transfers it (via the NNT task and the cross-domain for a normal cross-domain logon to that NCCF/NPDA. And> 

path} to the native domain for display service. this can be extended by using TAF enabling to have mul- 
| tiple concurrent active sessions to all NPDAs needed. 

Using the NCCF to NCCF task for communication with an 

NPDA tn another domain is, of course, an alternative 
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4.2.4 : NETWORK LOGICAL DATA MANAGER (NLDM) 


DESCRIPTION 


Network Logical Data Manager (NLDM) is intended to help 
the network systems and operations personnel solve log- 
ical errors which result in HUNG sessions. 


NLDM is a program product which operates with NCCF R2 
and which: 


® Collects data related to SNA sessions and data 
flows for certain non-SNA devices 


~- in virtual storage for the active sessions. 
- ina VSAM database for the terminated sessions. 


® Gives online hierarchical presentation to the 
NCCF/NLDM operator of the collected data 


~_ from this domain. 


- from a remote domain also running NLDM VIRI 
using the NCCF cross-domain facility. 


AVAILABILITY 


IBM Program Product 5668-971. 


REFERENCE MANUALS 
®  NLOM Installation and Operation . . $C€30-3165 


@ NLDM Diagnosis ........ . . 6C30-3166 


PRODUCT DEPENDENCIES 
® NCCF Rel. 2 
® ACF/NCP Ver. 2 


®  ACF/VTAM VIR2 or V2 (with the required PTF) 


FUNCTIONS 
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NLDM collects two types of session data: 


A 'Session Awareness Data' each time a session acti- 
vates successfully or terminates. 


« ‘Session Trace Data' during the trace operation 


consisting of: 
—- session activation parameters 
—- access method PIU data 
~- NCP data 
NLOM supports: 


e single or multi-domain sessions with at least one 
end point (primary or secondary) in the NLDM host 


© the following types of sessions: 
- SSCP - SSCP 
—- SSCP - PU 
- SSCP - LU 
- LU - LU 
NLOM traces: 
¢ local 
- SNA 
-  non-SNaA 
® remote 
_ SNA 
- BSC 3270 
- switched 
—- DR added (dynamic reconfiguration) 


—- NTO supported devices 


DATA COLLECTED 


All types of NLDM data can be collected only for ses- 
sions which are activated after NCCF/NLDM initializa- 
tion. For the remote resources this will occur if the 
CP was activated after NLDM initialization. For DR 
added or switched resources, since their addresses are 
dynamically assigned, tracing may be accomplished if 
global tracing is activated. 


SESSION AWARENESS DATA is collected for all data; 
traced or not, at session activation and session termi- 
nation. The following data is collected: 

® session type 

® session start/stop time 

e partner names 

® partner addresses 

® partner configuration information 

ACCESS METHOD PIU DATA continuously collected for 
traced sessions is comprised of the THs RH, and the 


first eleven RU bytes. 


NCP DATA (only 1f ACF/NCP V2) collected for traced ses- 
Sions at: 
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the SNA session end or device failure for FIDO 
devices 


the operator's request 


consists of: 


the last 
cept for 
OUT 


two IN and OUT PIU sequence numbers (ex- 
the SSCP - LU session), or the last three 


reference numbers and the last IN reference 
number for FIDO devices 


selected contents of NCP control blocks related to 
the type of resources 
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SNA PU T4¢ 
SNA PU T2 
SNA PU Tl 
SNA LU 


non-SN&A 


PSB» 
CUB, 
CUB, 
LUB 


DVB, 


SNP 
LKB, 


LKB, 


LLB, 


LXB » 


LXB > 


IOB,» 


CCB, AXB 


CCB, AXB 


LCB, AXB 
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NLDM DATA COLLECTED VERSUS TYPE OF RESOURCE 


RESOURCE 
TYPE 


HOST LU APPL 
LOCAL: 
SNA 
NON—SNA 
REMOTE 
SNA 
BSC 3270 
(NCP ATT.) 
NTO 
DR ADDED OR 
SWITCHED 


Table 1] 


NLOM INPUT DATA 


For single domain sessions the NLDM data comes from two 
sources: 


® the access method 
@ the boundary NCP function (for ACF/NCP V2 only) 
using two paths: 
® the CNM interface 
_ FORWARD RUs 
1. to the access method 


2. to the NCP 


SESSION TRACE DATA 


AWARENESS| PARA- 


METERS |PIUs | NCP DATA 


X Xx 


x 
x 
X 


— DELIVER RUs 
® the NCCF LU - ACF/VTAM LU session (PIU data) 


For multi-domain sessions the data comes from an alter- 
nate domain using an NCCF-NCCF cross-domain session. 


The DELIVER RUs can be either: 


e unsolicited RUs presented to NLDM when the data is 
generated, for: 


- session awareness data at session 
activation/termination. 


- NCP trace data at SNA session termination or at 
device failure for FIDO devices. 


@ solicited RUs presented to NLDM only on request, 
as a result of an NLDM operator intervention, for: 


- NCP trace data. 
DATA RECORDING 


Alternate recording in tno VSAM databases 
{primary/secondary ). 


e at session termination. For FIDO devices the NCP 
data will be recorded only if it was in storage, as 
a result of a device failure or an operator 
request. 


® by operator command. 

FORCE namel < name2 > 
The FORCE command will record only the data existing in 
storage. The NCP data and the last PIUs, which are not 
yet sent by the access method to NLDM, are in storage 
as a result of an cperator request and/or a device fai- 
lure for FIDO devices. 


Switch between the databases using the NCCF command 
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SWITCH AAUTSKLP,P to the primary database 
SWITCH AAUTSKLP,S to the secondary database 


The number of sessions retained per network node can be 
displayed using the command 


DISKEEP SESS namel ( name2 [| ALL ) 
and dynamically changed using the command 
KEEP nnn SESS namel ( name2 [| ALL ) 
There is no support of the VSAM shared option. 
NLDM COMMANDS 
There are two modes of operation for NLDM commands: 


® panel mode. All NLDM commands can be issued from 
an NLDM full-screen panel. 


e line mode. A subset of the NLDM commands (pre- 
ceded by the verb NLDM) can be entered directly 
from the NCCF screen, and can be used in CLISTs. 
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All the NLDM commands are explained using the NLDM HELP panel facility, 


with the exception of two commands: 


END stops the NLDM panel processing and 
returns control to NCCF. It also 
resets outstanding operator requests. 


FORCE namel < name2 > 


causes session data from storage to 


be recorded in the current database. 


The NLDM commands available in line mode are: 


NLDM TRACE START name | ALL < domainid > 


NLDOM TRACE STOP name | ALL < domainid > 


NLDM KEEP nnn PIUS namel < name2 | ALL > 


NLOM KEEP nnn SESS namel < name2 [| ALL > 


NLDM FORCE namel < name2 > 


NLDM END 


MULTI-DOMAIN SUPPORT 


PREREQUISITES: 


an NCCF-NCCF session between the domains 


an NLDM VIR1 active in each domain to coordinate 
the routing of requests between the domains through 
the NCCF-NCCF session 


TYPE OF SUPPORT: 


6 


IMPLICIT Used to view session data of a partner 
residing in another domain. NLDM from the alternate 
domain will collect the data corresponding to this 
session if a trace was started 


- either from the alternate domain using the com- 
mand TRACE START name | ALL 


- or from this domain using the command TRACE 
START name | ALL domainid where domainid is 
alternate domain identification 

EXPLICIT Used to view only the data collected by 

NLDM from the alternate domain. It requires the 

NLDM set domain command 


SDOMAIN domainid 


DIRECT The NLDM command 
TRACE START/STOP name | ALL domainid 


is sent directly to the alternate domain 


EXAMPLE 1 


The following is an example of when and how to use NLDM. It looks at the logic and the panels 


required to determine the reason for a hung session. 


HUNG SESSION 


| SESS —— | 


V 
select PT data 
of the session 
applic.— term. 


/——V—"\ 
7 mo RSPN Y investigate primary 
from |——> trace data of 
\N PLU 7 VTAM-PLU session 
\— | —7 
f——V—\N\ /———\ 
7 no RSP\N Y 7 is MY investigate primary 
from J——>] SLU an {> trace data of 
\ Stu # N applic. 7 VTAM-SLU session 
|Z VV |—7 
Vv: /———N\ /———\ 
select ST / REQ's \ N 7/7 pacing N 
for the |— >] SEQ# is [/——>| response | 
session \ OUT 7 \ outst. 7 
Vo jo —7 |Z 
f——V—\ N 
V / RSP's N Y V 
possible | SEQ# is i—| NCP problem | 
ERRONEOUS DATA \ IN / 
Vo | 7 
< 
V 
RESOURCE STATUS ERROR 
or 
UNRESPONSIVE TERMINAL 
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NLDM.SESS 


SESSION HISTORY FOR SELECTED NAU 


T140A0F8& DOMAIN: NCF11 


¥¥¥XX PRIMARY HHH HRHNX SECONDARY HHH 


NAME TYPE DOM NAME TYPE DOM 


START TIME END TIME 


NCF11002 
VTAM 
NCF11 
NCF11002 
NCF1l 
NCF11002 
NCF1i 
VTAM 
NCF11001 
TS01104 
TSOll 
VTAM 
TSO1104 
TSO11 


LU 
SSCP 
LU 
LU 
LU 
LU 
LU 
SSCP 
LU 
LU 
LU 
SSCP 
LU 
LU 


NCF11 
NCF11 
NCF11 
NCF11 
NCF1l 
NCF11 
NCF11 
NCF1l 
NCF11 
NCF1l 
NCFl1 
NCF11 
NCF11 
NCF1l 


TO VIEW MORE DATA 


SEL# AND PT(P-TRACE), ST(S-TRACE); 


TI1GOA0F8 
T140A0F8 
TIGOAOFS 
T140A0F8 
TI4GA0F8 
T140A0F8 
TI1GO0A0F8 
T1G0A0F8 
T140A0F8 
T140A0F8 
T140A0F8 
TI1G0A0F8 
TI140A0F8 
T1G0A0F8 


NCF11 
NCF11 
NCF1l 
NCF11 
NCF1l1 
NCF11 
NCF11 
NCF11 
NCF11 
NCF11 
NCF11 
NCF11 
NCF11 
NCF1ll 


PCSES 


Select primary trace data of the hung session. 


09/19 
09/19 
09/19 
09/19 
09/19 
09/19 
09/19 
09/19 
09/17 
09/16 
09/716 
09/16 
09/16 
09/16 


PARMS}; 


16:11:32 
16:09:10 
16:11:27 
15:59:29 
15:59:24 
11:35:07 
11:35:00 
11:34:23 
07:03:16 
19:57:08 
19:57:04 
19:55:38 
19:44:33 
19:44:30 


*¥**% ACTIVE *** 
HR ACTIVE %H 


09/19 
09/19 
09/19 
09/19 
09/19 
09/19 
09/17 
09/16 
09/16 
09/16 
09/16 
09/16 


16:11:43 
16:09:02 
15:59:40 
11:37:32 
11:35:15 
16:09:03 
09:58:39 
20:32:22 
19:57:21 
20:32:27 
19:55:42 
19:44:45 


PC(P-CON) OR SC(-CON) 


NLDOM.PIUT SPECIFIC SESSION TRACE DATA 
PRIMARY SECONDARY \------------- - DOM - 
NAME NCF11002 SA 0000000B EL 0075 | NAME TI1G0A0F8 SA COOOOD0E EL 00B4 | NCF11 


GMT HRHKKXXKX REQ/RESP HEADER ¥¥*%¥X*X RULEN SENS T 
21:12:07 ---.0C.DR.......BBEB 
21:12:09 ----OC.DR...... 
21:12:22 ----OC.ER 
21:12:23 ----OC.DR 
21:12:24 --.-OC.DR 
21:12:24 ----OC.D0R.......BBEB 
21:12:24 -+--OC.DR 
21:12:25 oeeeFC.ER 
21:12:25 ewes lC.DRe. ssa 0 


e 
e 


CD 


END OF DATA 
ENTER SEL# OR COMMAND 
R 


No response from terminal to the last PIU which requested 

a DR (SEQ# 1C). Note the sequence numbers: 

SLU ---> PLU (IN-BOUND ) PLU ---> SLU (OUT-BOUND ) 
19,1A 1B,1C 

Return to MOST RECENT SESSIONS display to select NCP data. 
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NLDM.SESS 


SESSION HISTORY FOR SELECTED NAU 
NAME: T140A0F8 DOMAIN: NCFII 


R¥XXX PRIMARY %¥¥HH %XHX SECONDARY 
NAME TYPE DOM NAME START TINE END TIME 
1} NCF11002 LU  NCF1l TI140A0F8 09/19 16:11:32 *** ACTIVE *x* | 

VTAM SSCP NCFI1 TI1460A0F8 09/719 16:09:10 *** ACTIVE xx 
NCF1l LU NCF11 T140A0F8 09/19 16:11:27 09/19 16:11:43 
NCF11002 LU  NCF11 TI140A0F8 09/19 15:59:29 09/19 16:09:02 
NCF1] LU NCF11 TI140A0F8 09/19 15:59:24 09/719 15:59:40 
NCF11002 LU NCF11l T14CA0F8 09/719 11:35:07 09/719 11:37:32 
NCF1l LU) NCF11 T140A0F8 09/19 11:35:00 09/719 11:35:15 
VTAM SSCP NCFI11L TI140A0F8 09/19 11:34:23 09/719 16:09:93 
NCF11001 LU NCF11 T140A0F8 09/17 07:03:16 09/17 09:58:39 
TSO1104 LU NCF11 T140A0F8 09716 19:57:08 09/716 20:32:22 
TSOl11 LU NCF11 TI1G40A0F8 09/16 19:57:04 09/16 19:57:21 
VTAM SSCP NCF11 T140A0F8 09/16 19:55:38 09/716 20:32:27 
TSO1104 LU NCF11 T140A0F8 09/16 19:44:33 09/16 19:55:42 
TSOll LU NCFI11 TIS4OA0F8 09/16 19:44:30 09716 19:44:45 


TO VIEW MORE DATA 
SEL# AND PT(P-TRACE), ST(S-TRACE), P(SES-PARMS), PC(P-CON) OR SC(-CON} 


“Select secondary trace data of the hung session. 


NLDM.NCPT SPECIFIC SESSION TRACE DATA 
SECONDARY -------------- ~ DOM - 
NAME NCF11002 SA 0000000B EL 0075 | NAME T140A0F8 SA OOQOO00E EL 00B4 | NCF11 


NCP LEVEL: V2 RESOURCE TYPE: SNA LU SEQNO: OO1C, 001B, OO1A, 0019 
O) a 60:6 05. Sees c1D see LBs 5 as wc 20. soe 2 Oeics 505 06 50 655i 35 

LUB: 0000000000000000008000001CB400000E000000000000000080000016750090058020 
00000000000900020000000000000000000000000000000000 


END OF DATA 
ENTER 'R' TO RETURN TO PREVIOUS DISPLAY - OR COMMAND 


The latest SEQ# OUT is 1C and the latest SEQ# IN 
is 1A. There is no response from the terminal with 
SEQ# IC in the IN flow. 
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&.3_ : NETWORK MANAGEMENT TOOLS 


4.3.1 : INFORMATION/MANAGEMENT 


DESCRIPTION 


Information/Management is a repository for Sytems Man- 
agement information. It is used for storage and 
retrieval of the following information items: 


¢ Problem management records 
© Change management records 
© Configuration management records 


D/B access is controlled through a privilege class 
structure. os | 


There are two versions of Information/System. While 
version 1 is still available and can be executed under 
NCCF, it is recommended that users use version 2 
because of improved usability. If 
Information/Management is executed within NCCF, each 
operator using it requires a large amount of storage 
Cabout 800K bytes). The operation for opening problems 
from NPDA is identical for both versions, however, more 
information is passed from NPDA V3 to 
Information/Management V2 than the other levels of NPDA 
and Information/Management 


INFORMATION MANAGEMENT V1 


Information/Management Version 1 operates under Infor- 
mation/System Rel. 2, which, in turn, can operate under 
both TSO and NCCF as a command processor. This product 
is MVS dependent. 

Primary differences: 

_ NCCF : All users in same address space. 


Advantage : Screen is shared with NCCF 


Disadvantage : High Virtual Storage requirements 
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TSO : All users have their own address space. 
Advantage : Less VS requirement 


Disadvantage : Requires second display unit or a 
TAF session. 


FEATURES 


e Single database for all 4 record types 
¢ Maintains 

1. Problem Management records 

2. Change Management records 


3. Configuration Management records, which are 
chained together 


&. Privilege Class Records 


e Powerful search facilities 


PROBLEM DETERMINATION HIGHLIGHTS 

® Problem entry by NCCF operator ensures no lost 
problems 

® Duplicate Problem recognition 

® Identifying components in a configuration path 

e Identifying component features 


¢  Problem/Change relationship recognition 


AVAILABILITY OPERATION 


P/P 5735-02ZS e From TSO via CLIST 


e From NCCF via command 


PRODUCT DEPENDENCIES 


® Information/System Rel. 2 
e NCCF or TSO 
e VSAM 


ee §€6OS/VS2 (MVS) 


REFERENCE MANUALS 
®  Information/System Pre-Installation Information. 
$C34-2027 


® Information/Sys Installation and Customization . 
$C34-2029 


e Information/Management Users Guide . ...... 
$C34-2031 


¢ Information/System Messages and Codes. .... . 
$C34-2043 


®  Information/Management Scenarios and Panel Flow. 
$C34-2045 


GG624-1514-1 TOOLS/SERVICE AIDS PAGE 4-75 


GG24-1514-1 


4.3.2 : NETWORK PERFORMANCE ANALYZER 


en Ne A TE ce a nota 


DESCRIPTION 


The Network Performance Analyzer FDP (NPA) monitors, 
collects, and displays network performance data which 
may be used for: 

® Highlighting causes of performance degradation 

® Tuning networks for better performance 

® Capacity planning for future growth 

The data gathered by NPA are available for online and 
offline evaluation. The FDP comprises two products, a 


HOST program and a NCP/NPA program. 


NPA has a companion FDP (NETPARS) which creates struc- 
tured reports from the NPA log output. 


FEATURES 


® Performance data collection 
® Interactive data display 


® Threshold controlled monitoring 


PROBLEM DETERMINATION HIGHLIGHTS 

@ Collects 3705, NCP, Message Traffic and Line Con- 
trol statistics by user criterion. 

® Provides immediate display of statistics. 


® Provides display of previously collected 
statistics. 


® Time of Day initiated monitoring. 
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AVAILABILITY 


® FDP 5798-CZT (Controller) 


® FDP 5798-CZR (Host} 


PRODUCT DEPENDENCIES 


® VTAM and/or TCAM 
e NCP 5 or ACF/NCP Rel 1 


¢ Network Performance Analysis Reporting System (NET- 
PARS ) 


This FDP is optional, but highly recommended. 


REFERENCE MANUALS 


® NPA AVAILABILITY NOTICE (GB21-2478) 


e NPA PROGRAM DESCRIPTION/OPERATIONS MANUAL 
(SB21-2479) 


OPERATION 


After the user logs on to NPA, he/she can enter com- 
mands. A summary of the NPA commands are listed here 
for reference. 


@ START/STOP COLLECT tells NPA to begin collecting 
data (immediately or at a future time). 


@  START/STOP DISPLAY initiates collection and display 
of data (the data displayed is changed at pericdic 
intervals}. 


e START/STOP MONITOR is similar to Display, but 
accepts a range of values and if the measured 


parameter falls outside of the range» a message is 
displayed at the terminal. 


® REVIEW causes the display of interval and total 
records for a given resource. 


® STATUS shows which of the commands START COLLECT; 
DISPLAY and MONITOR are active at this time. 


All data collected by any START command are recorded in 
2 files: the log and the review files. The review file 
is a VSAM file that keeps information for online 
reviewing by the operator if necessary. In the log file 
is the same information for offline processing, normal- 
ly by NPA LOGPRINT program. In these files there are 3 
types of records: 


Interval records, that contain data collected over 
the period specified by the interval parameter, 
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originated by any of the commands START COLLECT; 
START DISPLAY or START MONITOR. 


e Totals records with the information accumulated 
over a number of intervals. 


¢ Monitor records that contain exception data from an 
interval or a totals record. Each time a data value 
falls outside of the user limits (specified by 
START MONITOR) is generated one monitor record. 


INTERPRETATION 


This section includes one example of the use of NPA. 
Because NPA is interactive, the following log analysis 
has been produced by NETPARS. 
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DATE= TIME= SYSTEM=VS NETPARS REPORTS 
COMPOSITE DISTRIBUTIONS 


RESOURCE OUTBOUND QUEUE LENGTH LINE UTILIZATION PERCENTAGE 


| [ 
| | 
| | 
I AVERAGE STD DV MAX VALUE | AVERAGE STD DV MAX VALUE 
| 0.06 3.873 1 | 39.12 -428 59 
| 
| RANGE COUNT IN LINES, TERMINALS | RANGE COUNT IN ALL LINES 
| DISTRIB 3 RANGE AND CLUSTERS | DISTRIB 3. RANGE 
| TO MAXIMUM 0] {| TO MAXIMUM O| 
| 90 ol | 90 0] 
| 80 0| i 80 Oo] 
| 70 o| I 70 o| 
| 60 0 | | 60 1 & | 36363636 HSE EH HHI 
| 50 0| | 50 7 | 263636363636 
l 40 o| l 40 © | 26336 
| 30 ol | 30 & | 49% 
| 20 ol | 20 12 | HH HHHHH HHH 
| 10 1G | HHH HHH HHH HHH | 10 o| 
| ete se eee Seen tee, fi ee 
i | | | | Pb ere ee i | [ | | | 
| TOTAL= 16 10 20 30 460 50 | TOTAL= 50 4610 «6200630 «6400558 
LINE UTILIZATION PERCENTAGE | NCP FREE BUFFER QUEUE LENGTH | 
| | 
| | 
AVERAGE STD DV MAX VALUE | AVERAGE STD DV MAX VALUE | 
39.12 428 59 | 0.01 2.198 0 | 
| 
RANGE COUNT IN ALL LINES i RANGE COUNT IN NUMBER OF BUFFERS | 
DISTRIB 4 RANGE | DISTRIB 3. RANGE IN QUEUE I 
TO MAXIMUM 0] | TO MAXIMUM ol | 
190 Oo! | $0 0! | 
180 0| | 80 ol | 
170 0] | 70 ol | 
160 o] j 60 o| | 
150 0| | 50 0] 
140 o| | 40 o| | 
130 0] | 30 Ol | 
120 o| | 20 0] [ 
1106 BO | HII HAHAHAHA HHHH —s| 10 1G | HHH HHH HHH HHH HHH —| 
it Spaces ee ee et ett eee ee ene 
eateries | [ | | i | --------| | | | | | | 
TOTAL= 50 10 20 30 40 50 | TOTAL= 16 160 20 30 40 50 | 


DATE= 
10/01/81 
TIME 
HH.MM.SS 
8.57.00 
8.58.00 
DATE= 
10/01/81 
TIME 
HH.MM.SS 
8.57.00 
8.58.00 
DATE= 
10/01/81 
TIME 
HH .MM.SS 
8.57.00 
8.58.00 
DATE= 
10/01/81 
TIME 
HH.MM.SS 
8.57.00 
8.58.00 
DATE= 
10/01/81 
TIME 
HH .MM.SS 
8.57.00 
8.58.00 
DATE= 
10/01/81 
TIME 
HH .MM.SS 
8.57.13 


VALUE 


1.1 


VALUE 


0.0 


VALUE 


0.6 


DIFFC 


SECS 


60 


DIFFC 


SECS 


60 


VALUE 


8.57.14 3,688.0 


DATE= 
10/01/81 
TIME 

HH .MM.SS 
8.57.13 
8.57.14 
DATE= 
10/01/81 
TIME 

HH .MM.SS 
8.57.13 
8.57.14 
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VALUE 


1.0 


VALUE 


0.0 


TIME= SYSTEM=VS NETPARS REPORTS 
| TOTAL PIUS SENT AND RECEIVED PER SECOND | VALUE | TOTAL BYTES SENT AND RECEIVED PER SECOND | 
| ee 0.22 0.32 0.43 0.54 0.65 0.76 0.87 0.97 1.08 | 8,740 17,480 26,220 34,960 43,700 
|----|---- | ----|----|----|----]----]|]----|----|----| | ----|----|----]----]|----|----|----|----]|----|----| 
| 96 DE DE EH HEHEHE HEHE HEN IEEE HHH HHH HHH HHH III DIINO OEE 43655 | 963696 36336 3 IE SEI SE IE HE DE IE IE TE HEHE HEHEHE HEHEHE I SILI PILI LE LSE 
TIME= SYSTEM=VS NETPARS REPORTS 
| PIUS RETRANSMITTED PER SECOND | VALUE | BYTES RETRANSMITTED PER SECOND ; 
| 10 20 #30 40 50 60 #76 8060 90 ~=§100 | 10 20 30 40 50 #60 7006806906100 
| -~-~|----]~----]----|----]|----|----|----|----]----] | ----|----|----]|----|----|----|----]|----|----]----| 
| 0.0 | 
TIME= SYSTEM=VS NETPARS REPORTS 
| POSITIVE POLL COUNT TOTAL FOR ALL | VALUE | TOTAL POLL COUNT TOTAL FOR ALL I 
1 0.10 0.20 0.30 0.40 0.50 0.60 0.70 0.80 0.90 1 ] 250 500 750 1000 1250 1500 1750 2000 2250 2500 
| ----|----|----|----]----|----|----|----]----|----] | ----|----|----|----]|----]----]|----]----|----]----| 
| 96363 SE SESE IE DE IE HEE SE IE SE IE IE IE IE SE SE IE IE IE IE SE IE IEE IE 2 GBS .0 | 5636363636363 SE SESE DE SESE SESE DE SESE SE SESE SEE IE DE ESE IEE IE SE SEE SESE SE ESE EE EE SESE 
TINE= SYSTEM=VS NETPARS REPORTS 
VALUE | TEMPORARY ERRORS PER SECOND TOTAL FOR ALL 
| 5 10 15 20 25 30 #35 40 45 #50 55 60 #65 70 #75 86 8 930 95 = 100 
| ----]----|----]----|----|----]----|----|----|----]----]----|----|----]|----]----|----|----|----|----] 
0.0 | 
TIME= SYSTEM=VS NETPARS REPORTS 
VALUE | RESOURCE OUTBOUND QUEUE LENGTH TOTAL FOR ALL 
1 0.05 0.10 0.15 0.20 0.25 0.30 0.35 0.40 0.45 0.50 0.55 0.60 0.65 0.70 0.75 0.80 ei were i 
| ----|----|----]----|----|----|----|----|----|----|----]----]----|----]----]|----|]----|----|----]---- 
1.0 | 363636 36 36 96 IE NE DE IE IE DE IE IE DE IE FE IE IE SE HEHE DE FE HE HE HEHE HE IE IE IE IE IE IE IE IE FE FE IE BEE HE HEHEHE HEHE IEE IE IE IE SE IE SE IE IE SE HE SESE HEHE IE IE IE IE IE IE HEHE IEE FE HE DE IE SHE IE DE HEE HEE SE IEE IEE HEHE EEE EE HE EDE 

TIME= SYSTEM=VS NETPARS REPORTS 
| FREE BUFFER LOW AND HIGH WATER MARKS | VALUE | FREE BUFFER QUEUE LENGTH l 
| 370 740 1110 1480 1850 2220 2590 2960 3330 3700 ! 190 380 570 760 950 ans a ve bh a 
| ----|----|----|----|----|----|----|----]----|----] | ----|----|----|----|----|----|----|----|----|---- 
| HEHEHE HHH IIH IH HHH HHH HK HKHHRNMRS ISIE AAA AA A 1 5 B52 £0 | RIE IE HEH HEHEHE HEHEHE HEHEHE HEE HEHEHE HEHE HE SEH HEHE HEHEHE HEH HEHE HEHE HEHE HE HEHEHE 


TIME= SYSTEM=VS NETPARS REPORTS 

CHANNEL HOLD QUEUE LENGTH | VALUE | CHANNEL INTERMEDIATE QUEUE LENGTH | 
| 0.10 0.20 0.30 0.40 0.50 0.60 0.70 0.80 0.90 1 { 0.10 0.20 0.30 ae ser sha a ae a 
| ----]---- |--+- | --~-|---~]---- | ---- |----]----1---- | | ----|----|---- | ----|----|---- [---- ]----|-------- 
| 35363 HEHE EEE HEHEHE HE EH HEH HEHEHE HEH HEH HHH HHH HH HEHEHE HH HEH HEH HE K HEHEHE 1.0 | 963696969696 9696 HEHE IE IEEE HEHEHE HEHE HEHEHE DE HEHE IE BE HEIE FE HEHE HEHEHE DE HE IE DEI HE TE IE IE IE DEE IE DE 


TIME= SYSTEM=VS NETPARS REPORTS 

| NCP TIME IN SLOWDOWN (TENTHS OF SECONDS) | VALUE | NCP IDLE TIME( TENTHS OF SECONDS) | 

| 10 20 30 40 50 60 70 80 90 100 | 50 100 150 200 250 300 350 400 450 500 
| ---~|--~- | ---- | ----[----]---- | ----J----|----]----1 | ---- |----|----] ----]---- | ---- | ---- | ---- ----1---- 

| 498.0 | 9636 HE IE HEHE HEHEHE IE IE HE HEHEHE HIE HEHEHE IE HIE HEHE HEINE K HHI HIE HE HEHE HHH HH HH KH HE 
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DATE= TIME= SYSTEM=VS NETPARS REPORTS 
START=10/01/81 08.57.13.93 SYSTEM=VS NETPARS REPORTS END 10/01/81 08.57.15.02 PAGE 
RESOURCE USAGE GRAPHS 
MAXIMUM RATE BY ANY RESOURCE  PIUS PIUS BYTES BYTES QUE TOTAL POSITIVE ERRORS RETRY RETRY 
ELASPED TIME 0 SENT REC. SENT REC. LGTH POLLS POLLS PER PIU BYTE 
MINUTE | MINUTE SECOND SECOND SECOND SEC. MINUTE MINUTE SECOND 
MAX USAGE BY ANY 10 5 2,872 1,441 1 239 0 0 0 0 
AVERAGE USAGE FOR PIUS SENT LINES MAXIMUM AVERAGE = 10.30 
RESOURCE NAME = -------- 10--~--+-~-- 20-------~- 30-------- 40-~------ 50--~----- 60-----~-- 70-------- 80-------- 90-~---~-~ 100% OF MAX. 
LIGOA5  25RRK 
L14028 2B RHK 
START=10/01/81 08.57.13.93 SYSTEM=VS NETPARS REPORTS END 10/01/81 08.57.15.02 PAGE 
RESOURCE USAGE GRAPHS 
MAXIMUM RATE BY ANY RESOURCE  PIUS PIUS BYTES BYTES QUE TOTAL POSITIVE ERRORS RETRY RETRY 
ELASPED TIME 0 SENT REC. SENT REC. LGTH POLLS POLLS PER PIU BYTE 
MINUTE | MINUTE SECOND SECOND SECOND SEC. MINUTE MINUTE SECOND 
MAX USAGE BY ANY 10 5 2,872 1,441 1 239 0 0 0 0 
AVERAGE USAGE FOR PIUS RECEIVED LINES MAXIMUM AVERAGE = _ 5.52 
RESOURCE NAME = -------- 10--~--~~- 20-------- 30-------- 40-------- 50------~- 60-------- 70-~------ 80-------- 90-~----- 100% OF MAX. 
LIG0A0 B BORK KKH HHH KKK HH HH HK HHH HK HHH HHH HHH HK IE HH IH HHH HIE HEHE HE HEHEHE HEH HE HEE ETE HE IE HEHEHE HEHEHE HEHEHE HE HEHEHE HEHEHE HEHE HHH HH HHH HH HH KKK KKHKKHKK 
START=10/01/81 08.57.13.93 SYSTEM=VS NETPARS REPORTS END 10/01/81 08.57.15.02 PAGE 
RESOURCE USAGE GRAPHS 
MAXIMUM RATE BY ANY RESOURCE  PIUS PIUS BYTES BYTES QUE TOTAL POSITIVE ERRORS RETRY RETRY 
ELASPED TIME 0 SENT REC. SENT REC. LGTH POLLS POLLS PER PIU BYTE 
MINUTE | MINUTE SECOND SECOND SECOND SEC. MINUTE MINUTE SECOND 
MAX USAGE BY ANY 10 5 2,872 1,441 1 239 0 0 0 0 
AVERAGE USAGE FOR BYTES SENT LINES MAXIMUM AVERAGE = 2,872.15 
RESOURCE NAME = =~---~-~~ 10-------- 20----~---- 30---~---- 40-------- 50Q-------- 60-------- 70-------- 80-------~ 90------- 100% OF MAX. 
L140A0 149. 9G xX 
LIGOAG 18.77% 
Li¢G60A5 368 , GEXKKRKKKHKKHKKKHKE 
L1402C 2 9 BITS 5 LE KK HHH HK HHH HH HHH HH HK HH HHH HH HH HK HK HK HH HHH KH HH HH HHH HHH HH HHH HHI HE HHH HH HHH HHH HHH HHH HH HHH HHH HH KKK KKK HH KHKKKKKHK 
L14028 2S 9871 BL KKK KK KKK HHH KK HHKHK KKH KKH HAH HH KKH HH KKK KKK KKK HK KKK KKK KKK KKK KKH HK KKH KKH HK HK KKH KKK HK K KKK KKK K KKK KKK KKKEKKEREKK 
START=10/01/81 08.57.13.93 SYSTEM=VS NETPARS REPORTS END 10/01/81 08.57.15.02 PAGE 
RESOURCE USAGE GRAPHS 
MAXIMUM RATE BY ANY RESOURCE PIUS PIUS BYTES BYTES QUE TOTAL POSITIVE ERRORS RETRY RETRY 
ELASPED TIME 0 SENT REC. SENT REC. LGTH POLLS POLLS PER PIU BYTE 
MINUTE § MINUTE SECOND SECOND SECOND SEC. MINUTE MINUTE SECOND 
MAX USAGE BY ANY 10 5 2,872 15441 1 239 0 0 0 0 
AVERAGE USAGE FOR BYTES RECEIVED LINES MAXIMUM AVERAGE = 1,441.53 
RESOURCE NAME = -=------- 10-------- 20-------- 30--~----- 40~------- 50-------- 60-------- 70-------- 80--~------ 90~------ 100% OF MAX. 
L1G0A0 35 56m 
LIGOAG 18.77% 


L1402C L 5 G36 . DL KKK HHH HHH HHH HHH HHH HH KK HHH HH HK HHH HK KH KK HK HHH KK HK HK HK HHH HK HK KKH KKH KKH KKK K KKH HK KKK KEKE KKEFEKKKKKK 


114028 Lp GGL . 5 BHI IH HEHE HEHEHE HEHEHE IEE HEHEHE HEHEHE SEI HEHEHE IE HEHE IE HE HEHEHE HEHEHE HEHE IE IE HEHE IEE HEHE IEE HEHE IE HEHEHE HEHE HEHEHE HEHEHE HEHEHE TE HEHE FETE HEHEHE IEE HE IEHEHESE HE IESE HEHE HEHE IE HE HEHEHE IEE 
L14040 GH, CE KKRHK HHH HHH HHH HHH HH HHH HH HHH HHH HH HIE 
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START=10/01/81 08.57.13.93 SYSTEM=VS NETPARS REPORTS END 10/01/81 08.57.15.02 PAGE 
RESOURCE USAGE GRAPHS 
MAXIMUM RATE BY ANY RESOURCE PIUS PIUS BYTES BYTES QUE TOTAL POSITIVE ERRORS RETRY RETRY 
ELASPED TIME 0 SENT REC. SENT REC. LGTH POLLS POLLS PER PIU BYTE 
MINUTE MINUTE SECOND SECOND SECOND SEC. MINUTE MINUTE SECOND 
MAX USAGE BY ANY 10 5 2,872 1,441 1 239 0 0 0 0 
AVERAGE USAGE FOR QUE LENTH. AVG. LINES MAXIMUM AVERAGE = 1.00 
RESOURCE NAME -------- 10-------- 20-------- 30-------- 40-------- 50-------- 60-------- 70-------- 80-------- 90------- 100% OF MAX. 
. LIGOAD Le . OD E32 HEHE HEHEHE HEHEHE HEHE HEHEHE IE IE HIE HEHE HE FE HE IE IE IE FE FE IE FE SE HEHEHE SE IE IE ESE IEE HEHE IE IE IE IE IE IE HE HE IE HE IE IE IE FE IE HE IE IE IE IE HEHE IE JE FE SE HE IE FE HEHE IE HEHE FE HE HE HE FE HE IE HE HE HE DE TE HE HE HEHE HE HEHEHE 
START=10/01/81 08.57.13.93 SYSTEM=VS NETPARS REPORTS END 10/01/81 08.57.15.02 PAGE 
RESOURCE USAGE GRAPHS 
MAXIMUM RATE BY ANY RESOURCE PIUS PIUS BYTES BYTES QUE TOTAL POSITIVE ERRORS RETRY RETRY 
ELASPED TIME 0 SENT REC. SENT REC. LGTH POLLS POLLS PER PIU BYTE 
MINUTE MINUTE SECOND SECOND SECOND SEC. MINUTE MINUTE SECOND 
MAX USAGE BY ANY 10 5 2,872 15441 1 239 0 0 0 0 
AVERAGE USAGE FOR TOTAL POLLS LINES MAXIMUM AVERAGE = 239.34 
RESOURCE NAME -------- 10-------- 20-------- 30-------- 40-------- 50-------- 60-------- 70-------- 80-------- 90------- 100% OF MAX. 
L140A0 G.91%** 
L140A4 2. 50x 
LIGOA5 GB 5 SE HHH HHH HHH HEH IH HH HHH HHH HHH HHH 
L1402C SD. BERR HHH HK HHH HHH HK HHH HH HK HHH HHH HI HHH HHH HK HH HHH HHH HHH HH HH HHH HHH HHH HHI HH HH KH HHH HHH HH HH HHH HHH HHH HH HR HHH HHH HHH 
£14028 23D 2 LHRH KKH KH H HHH HK HHH HHI KH HHI IH IIH HE IESE HE EEE HE EE IE HEHE HE HE HEHEHE HE IEE HEHEHE IE HE IE IE IEE IEEE IE EEE EI HK KKH HHH HH 
L140498 ZT gO LKR HH KKH HHH HK HK HHH KH HHH KH KH HK KKK 
START=10/01/81 08.57.13.93 SYSTEM=VS NETPARS REPORTS END 10/01/81 08.57.15.02 PAGE 
RESOURCE USAGE GRAPHS 
MAXIMUM RATE BY ANY RESOURCE PIUS PIUS BYTES BYTES QUE TOTAL POSITIVE ERRORS RETRY RETRY 
ELASPED TIME 0 SENT REC. SENT REC. LGTH POLLS POLLS PER PIU BYTE 
MINUTE MINUTE - SECOND SECOND SECOND SEC. MINUTE MINUTE SECOND 
MAX USAGE BY ANY 10 5 2,872 15441 1 239 ) 0 0 0 
AVERAGE USAGE FOR POSITIVE POLLS LINES MAXIMUM AVERAGE = .09 
RESOURCE NAME  --~----- 10-------- 20-------- 30-------- 40-------- 50-------- 60-------- 70-------- 80---~---- 90--~---- 100% OF MAX. 
LI40A0 DKK HKHHIHK EHH HH HHH HK HH KK HHH HHH HHH HHH HHH IEEE HEH HEHEHE HHH HK HH HH HHH HEHE HH HH IH HK HH HHH IE HIE HHH HHH HHH HK HHH KH K KKK KKKKK 
L140A5 OD HK HHH HK HHH HHH HH HHH HHH HHH 
L1402C¢ OOK HHH 
L14028 DSK KHK HK HHH HK HH KH HHH HHH KK HH KKKRHHXH 
START=10/01/81 08.57.13.93 | SYSTEM=VS NETPARS REPORTS PAGE 
NCP DETAIL TRACE REPORT 
TIME NCP TOT NCP FREE FREE FREE CHANNEL CHANNEL NCP NCP MAXIMUM INTERVAL 
LOGGED RESOURCE IDLE BUFF BUFF BUFF INTER. HOLD SLOW SLOH AVAIABLE 
NAME TIME QUEUE HIGH LOW QUEUE QUEUE  DOKN DOHN NCP SIZE 
LENGTH MARK MARK LENGTH LENGTH TIME LIMIT BUFFERS SECONDS 


08.57.13 NI4BF3P 49.8 1852 1859 1829 1 1 0 206 1655 238.7 


START=10/01/81 08.57.13.93 SYSTEM=VS NETPARS REPORTS PAGE 
RESOURCE DETAIL TRACE REPORT 
TIME NAME TYPE TOT PIUS PIUS BYTES BYTES QUE TOTAL POS. ERROR RETRY RETRY SAMPLE LINE 
SENT REC. SENT REC. LGTH POLL POLL COUNT PIU BYTE SIZE UTIL. 
COUNT COUNT COUNT COUNT SECONDS PRI. SEC 
08.57.14 L14020 LINE 0 0 0 0 0 0 0 0 0 0 238 0c 900 
98.57.14 L14022 LINE 0 0 0 0 0 8) 0 0 0 0 238 C0 NO 
08.57.14 L1i40A0 LINE 41 22 35,791 8,490 1 1173 22 0 0 0 238 25 06 
08.57.14 Li40A2 LINE 0 0 0 0 0 9 0 0 0 0 238 Go =6NO 
08.57.14 L140A4 LINE 0 0 4482 45482 0 597 0 0 0 0 238 06 NO 
08.57.14 L140A7 LINE 0 0 0 0 0 0 0 0 0 0 238 06 NO 
08.57.14 114043 LINE 0 0 0 0 0 0 0 0 0 0 238 ¢O NO 
68.57.14 114023 LINE 0 0 0 0 0 0 0 0 0 0 238 00 NO 
08.57.14 L140A3 LINE 9 0 0 0 0 0 0 6 0 0 238 00 NO 
08.57.14 114024 LINE 0 0 0 0 0 0 0 0 0 0 238 09 NO 
08.57.14 114026 LINE 0 0 0 0 0 0 0 0 0 0 238 06 NO 
08.57.14 L14028 LINE 1 0 685,430 344,095 6 8420 7 0 4) 0 238 288 144 
08.57.14 L1402C LINE 0 0 685 »584 342,991 0 8404 1 0 0 0 238 289 144 
08.57.14 114040 LINE 0 0 221,166 110,586 0 18431 0 0 0 0 238 77 639 
08.57.15 114042 LINE 0 0 0 0 0 0 0 0 0 0 238 00 NO 
08.57.15 L140A5 LINE 1 0 87,950 88,273 0 14653 5 0 0 0 238 62 NO 
SUBTOTAL INTV. RECS 16 43 22 1,720,403 898,917 1 49102 35 0 0 0 3819 
AVG. PER SEC. 0 0 450 235 0 39 0 0 0 0 3 
GRAND TOTALS. 32 43 22 1,720,403 898,917 1 49102 35 0 0 0 3819 
AVG. PER SEC. 0 0 450 235 0 39 0 0 0 0 3 
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START=10/01/81 08.57.13.93 


TIME NAME TYPE NEGATIVE 
POLLS 
MINUTE 
08.57.13 NIGBF3P NCP 
08.57.14 L14020 LINE 
08.57.14 L14022 LINE 
08.57.14 L140A0 LINE 289 
08.57.14 L140A2 LINE 
08.57.14 LI4G0A4 LINE 150 
08.57.14 L140A7 LINE 
08.57.14 L14043 LINE 
08.57.14 L14023 LINE 
08.57.14 L140A3 LINE 
08.57.14 114024 LINE 
08.57.14 L14026 LINE 
08.57.14 L14028 LINE 2,118 
08.57.14 L1402C LINE 2,112 
08.57.14 L14040 LINE 4,632 
08.57.15 114042 LINE 
08.57.15 L140A5 LINE 3,681 
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SYSTEM=VS 
POSITIVE PIU 
POLLS RATE 
MINUTE 

5 15 


NETPARS REPORTS 
MANAGEMENT EXCEPTION REPORT 


BYTE LINE 
RATE UTILZ. 
PERCENT 


15 


ERROR QUEUE 3705 

COUNT LENGTH UTILZ. 
PERCENT 
— 79 


PAGE 4-84 


FREE SLONDOKN TIME 


BUFF .PERCENT 
PERCENT 
112 


SAMPLED 


238 
238 
238 
238 
238 
238 
238 
238 


PAGE 


1 


4.3.3 : EREPI 


DESCRIPTION 


EREP] is an IBM Service Aid Program that permits the 
analysis of error data accumulated in the 
SYS1.LOGREC(OS/VS) or SYSREC(DOS/VSE) datasets. It 
operates as a batch job. Its primary importance for 
SNA Problem Determination is realized in installations 
that do not use NPDA. 


BASIC FUNCTIONS 


® CREATE AN ACCUMULATION DATASET FROM SYS1.LOGREC AND 
CLEAR SYS1.LOGR EC 


EREP1 can create an accumulation dataset (history) 
either selectively by record criteria or in full. 
Whenever a full copy is created, the SYS1.LOGREC 
can be cleared. 


® COPY AN INPUT ACCUMULATION DATASET TO AN OUTPUT 
ACCUMULATION DATASET 


EREP] can generate an output dataset from an input 
accumulation dataset. The output can be a full copy 
of the input or can be a selective copy containing 
only the desired record types. One output dataset 
can be generated from several input datasets by 
concatenating the input DD statements. 


® MERGE DATA FROM AN ACCUMULATION DATASET AND 
SYS1.LOGREC | 


EREP] can accept input from both an accumulation 
dataset and SYS1.LOGREC in a single step. The out- 
put dataset can be a full copy of both input sets 
or can be a selective copy containing only the 
desired record types. 
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e PRINT DETAILED DESCRIPTION OF THE HARDWARE AND 
SOFTWARE ERROR RECORDS 


All records or selected records on the input data- 
set can be printed in a detailed format which is 
dependent upon record type. 


e SUMMARYTZE AND PRINT STATISTICS FOR DEVICE FAILURES 
Data contained on SYS1.LOGREC and/or an accumu- 
lation dataset can be summarized by device type or 
system function. Several reports are available via 
parameter Keywords, e.g., SYSUM=Y requests a system 
summary report of all records on the input dataset. 


e FORMAT RELIABILITY MEASUREMENT DATA 


EREP1 can format a report of reliability data from 
IPL records on an accumulation dataset. 


EREP1 REPORTING FUNCTIONS 


During an EREP1 execution only one of the following 
functions can be performed: 


e SYSTEM SUMMARY REPORTING 
EREP1 can be used to generate a comprehensive con- 
densed report of errors for the principal system 
elements. The system summary provides data in three 
major categories: 
1. CPU/Channels/Storage/SCP 
2. Condensed I/0 Subsystem Summary 


3. MDR Summary Reporting 
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TREND REPORTING 


This function enables the user to specify a time 
frame -max of 30 days- for which data is to be sunm- 
marized by daily activity. The number of days 
reported depends on the input data and parameters. 
When no date range is specified, thirty days of 
data ending with the current day are presented. 
Trend Reporting is recommended to be done every 
seven days, using a DATE parameter of the last sev- 
en days. 


EVENT HISTORY REPORTING 


EREP1 can be used to generate a report of one line 
abstracts of all records recorded within a speci- 
fied time frame. This report also permits examina- 
tion of selected record types within the context of 
the overall recorded activity. 


MEDIA ERROR STATISTICS/THRESHOLD REPORTING 


EREP1 can be used to generate reports of error sta- 
tistics for 3410 and 3420 tape subsystems or a sum- 
mary report for a 3420 tape subsystem. 


RECORD DETAIL AND SUMMARY REPORTING 


EREPL can be used to edit and print all or any 
selected records on the input dataset. Data from 
the records can be summarized and the summary 
printed. The parameter-PRINT-indicates whether 
detailed and/or summaries are to be printed. 


~RDE SUMMARY REPORTING 


ACF/SNA SYSTEM PROBLEM DETERMINATION GUIDE Vol. I : PAGE 4-86 


If RDE has been included as a system option, EREPI 
can be used to generate a summary of IPL and error 
records from an accumulation data set. Control 
information must be input via control cards follon- 
ing the SYSIN DD statement to specify the reporting 
period and the IPL clustering interval. 


SYS1.LOGREC OFFLOAD 


This function is provided for AN EMERGENCY CAPABIL- 
ITY TO CLEAR SYS1.LOGREC at a time when it is 
imperative to clear the dataset and not feasible to 
execute EREPl] using normal execution. If it is 
required to examine the error that can not be 
logged, run EREP to retreive that record first. 


AVAILABILITY 


EREP1 is supported by the following system/releases: 


% 


%* 


* 


OS/VS1 Release 5.0 
Independent Component Release UX99936 
OS/VSI1 Release 6.0 
Selectable Unit VS1.06.601 
Selectable Unit 5741-620 
OS/VS2 Release 1.7 (SVS) 
Independent Component Release UX99942 
Independent Component Release UX99951 
OS/VS2 Release 3.0 and 3.6(MVS) 
Independent Component Release UX99946 
OS/VS2 Release 3.7(MVS) 
Selectable Unit VS2.03.827 
Selectable Unit 5752-851 
OS/VS2 Release 3.8(MVS) 
DOS/VSE 
VM/370 Release 6 and up 


REFERENCE MANUALS 


SVS, VS1, MVS, DOS/VSE, and VM/370 
OS/VS ,DOS/VSE, VM/370 Environmental Recording and 

and Printing (EREP) Program... .... ee ee 
OS/VS Message Library: EREP Messages. ... 
EREP Program Reference. . ......- 
VS1 
GS/VS1 SYSI1.LOGREC Error Recording. .. . : aw 


OS/VS1 Message Library: Service Aids and OLTEP Hawssces 
SVS 


O5/VS SYS1.LOGREC Error Recording. ......-. ees. 
OS/VS Message Library: Service Aids and OLTEP Messages. 
HVS 

O3S/VS2 SYSI1.LOGREC Error Recording. ee -ud es Ss Te we 
~~OS/VS2 System Programming Library : earvice Aids 4.3 


od e ° e e 


e ® * e e e Sd e 


OPERATION 


Each record on SYSI1.LOGREC contains complete and spe- 
cific information for the device, and type of failure 
or system condition that caused it to be written. For 
example, if a device failure occurs on a teleprocessing 
device connected to an IBM 3704 or 3705 device or on an 
IBM 3704 or 3705, the respective device-dependent 3704 
or 3705 ERP receives control. If the error is of the 
kind that inherently cannot be recovered, the Network 
Control Program (NCP) makes no error recovery attempt 
but immediately indicates a permanent error by sending 
an MDR record to the host CPU. The following is a list 
of errors that NCP considers permanent and no error 
recovery 1s attempted: 


1. Received SDLC Command Reject Response (CMDR). 
2. Received Invalid SDLC Command. 

3. Adapter Check. 

4. Adapter Feedback Check. 

5. Modem Error. 

6. Transmit clock or clear to send failure. 

7. Data set ready turn on or off check. 

8. Auto call check. 
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- 6C28-1178 
- 6038-1179 
» G6C29-8300 


- 6C28-0668 
- 6023-0005 


- GQ28-0638 
- GTO0-0129 


- 6GC28-0677 
- GC28-0674 


9. Program failure. 


Temporary errors in NCP are separated into three sepa- 
rate recovery procedures depending on the error type. 


1. The first temporary error recovery procedure is to 
handle I-format receive errors. This procedure han- 
dles retry of the following: 


° Data check 
® Format check 
° Abort 


A common field in the Station Control Block is used 
to maintain a count of this type of temporary 
error. When this field reaches the preset Limit of 
64, a permanent MDR record is generated with the 
Monitor Count Overflow bit set in the LXB extended 
status field. 


2. The second temporary error recovery procedure 15 
for Underrun errors. This is an error that occurs 
during a transmit operation. A field in Link XIO 
Control Block is used to maintain a count of this 
error. When this count reaches the preset limit of 
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127 a permanent MDR recorded is generated with the 
Underrun bit set in the LXB extended status field. 


3. If the temporary error is not of the I-format 
receive or Underrun type, then the common error 


SAMPLE OUTPUT 


\ 
\ 


recovery procedures are used to handle the error. 
When the number of retries has been done wi thout 
recovery, a permanent MDR is generated indicating 
the initial and the final error conditions. 


In this section, there are samples of the output records that are available from EREP1. The follow- 


ing format is used in this section: 


¢ A sample of the record is displayed. 


® A description of what fields you should look at and what they mean. 


e 6A list of the parameters that were used to generate the report. 


Example 1: SYSTEM SUMMARY MDR SAMPLE .... . 
2: MDR SUMMARY REPORT SAMPLE .... . 
> TRENDS REPORT MDR SAMPLE... .. .- 


e 


4: PERMANENT LINE ERRORS FOR BSC & S/S MOR 
5: PERMANENT SDLC LINE ERROR MDR SAMPLE. 


6: SDLC STATION ERROR MDR SAMPLE .. . 
7: BSC STATION STATISTICS MOR SAMPLE . 

: COMMUNICATION SCANNER MOR SAMPLE. . 
9: LINE SUMMARY RECORD MDR SUMMARY . . 
10: END OF DAY RECORD MDR SUMMARY ... 


e 


e 


SAMPLE 


4-90 
4-93 
4-95 
4-97 
4-100 
4-103 
4-106 
4-108 
4-110 
4-112 


NETWORK MONITORING 


The purpose of error recording on the SYS1.LOGREC 
(OS/VS) and SYSREC (DOS/VS) datasets is to provide a 
record of all hardware failures, selected software 
errors, and system conditions. Information about each 
incident is written onto SYSI1.LOGREC or SYSREC by the 
system recording routines and can be retrieved by using 
a service aid. The service aid output can be used for 
diagnostic and/or measurement purposes to maintain the 
devices and support the system control program. 


It is essential that the users set up procedures for 
listing and monitoring SYS1.LOGREC or SYSREC. A commu- 
nication system requires daily monitoring and if proce- 
dures are not set up, the following is recommended: 


\ 


The System Summary report should be run on a daily 
basis, and the totals scanned to determine if there 
is a problem that requires further analysis. The 
temporary and permanent error counts should be com- 
pared to your trend reports to establish an average 
error rate for each I/O and system component. These 
daily reports should be retained until a trend 
report has been run which includes the data in this 
report. 


The trend report should be used to determine the 
day to day operation of your system. Retaining a 
copy of the trend report in a history book will 
allow you to establish an average level of line 
errors and a normal level of system problems. If 
the error levels start to rise, using trend will 
enable you to determine what type of action needs 
to be taken before the errors reach the point of 
Impacting your system operations. 
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Example 1: SYSTEM SUMMARY MDR SAMPLE 


SYSTEM SUMMARY REPORT DATE 027 78 
(PART 1) PERIOD FROM 027 78 
CPU/CHANNEL/STORAGE/SCP TO 027 78 
TOTAL CPU-A 
IPL 0 0 


MACHINE CHECK 


RECOVERABLE 0 0 
NON-RECOVERABLE 0 0 
CHANNEL CHECK 
CHANNEL 0 0 0 
CHANNEL 1 0 0 
CHANNEL 2 0 0 
CHANNEL 3 0 0 
CHANNEL 4 0 0. 
CHANNEL 5 0 0 
- CHANNEL 6 0 0 
CHANNEL 7 0 0 
CHANNEL 8 0 0 
CHANNEL 9 0 0 
CHANNEL A 0 0 
CHANNEL B 0 0 
CHANNEL C 0 i) 
CHANNEL D 0 0 
CHANNEL E 4) 0 
CHANNEL F 0 0 
PROGRAM ERROR 
PRGM INT 1 1 
ABEND 9 9 
RESTART 0 0 
END OF DAY 0 0 
TOTAL RECORDS 10 10 


CPU MODEL SERIAL NO. 
A 0168 060009 


SYSTEM SUMMARY 


3705 016 
LINES 
2701 034 

CNTRLR 
2701 057 
CNTRLR 
2701 076 
CNTRLR 
3705 118 
LINES 
3705 11C 
LINES 


TOTALS 


CPU MODEL 
A 0168 


(PART 2) 
I/O SUBSYSTEM 


TOTAL 


PERM TEMP 
TP CNTR — 363636369636963696 69-969 


1 0 

1 0 

4 0 

1 0 

75 39 

380 239 

469 1380 
SERIAL NO. 

060009 


INPUT PARAMETER STRING 


PARAMETER OPTIONS VALID FOR THIS EXECUTION 


RECORD TYPES(MCH,CCH,OBR,SOFT,IPL,DDR,MIH,EOD,MDR),SYSTEM SUMMARY,LOGREC INPUT,DUMP SDR COUNTERS 
DATE/TIME RANGE - ALL 


HKXKKHKKKKHKKKKXKKKKEND OF SAMPLE REPOR Tx HH RIN 
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CPU~-A 


PERM TEMP 


1 0 

1 0 

& 0 

1 0 
75 8639 
380 239 


469 1380 


ACC=N,SYSUM=Y 


REPORT DATE 027 78 
PERIOD FROM 027 78 
TO 027 78 


EREP1 INFORMATIONAL MESSAGES 


TOOLS/SERVICE AIDS 


DATE - 027 78 
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The parameters used to obtain this sample report limited the output in the I/O section to 3705s, 
DEV=(3705), did not create a history tape ACC=N, and did not zero out SYSI1.LOGREC. For a normal 
report, you would include all I/O (no DEV), generate a history tape, ACC=Y, and zero out 
SYS1.LOGREC, ZERO=Y. This report should be run on a daily basis, and the totals scanned to determine 
if there is a problem that requires further analysis. The temporary and permanent error counts 
should be compared to your trend reports to establish an average error rate for each I/0 and system 


component. These daily reports should be retained until a trend report has been run which includes 
the data in this report. 


The parameters used were: 


//STEP1 EXEC PGM=IFCEREPI, 

7/ PARM='ACC=N; PRINT=SU,DEV=(3705), TYPE=CDEHIMOST ' 
//7SYSPRINT DD SYSOUT=A 

//SERLOG DD DSN=SYS1.LOGREC,DISP=SHR 

/7EREPPT DD SYSOUT=A,DCB=BLKSIZE=133 

//SYSUDMP DD SYSOUT=A,DCB=BLKSIZE=133 


PAGE 4-92 


Example 2: MDR SUMMARY REPORT SAMPLE 


RAR Nar erent NERA OO DEFOE tC 8 ED Pree RPC SS erass erento fennaonstnnetoor ats nas areinengugepatas nee 


~-~SUMMARY OF ENTRY TYPE - 3705 MOR 


DAY YEAR 
DATE RANGE- 256 


DAY YEAR 
78 TO 256 


CHANNEL UNIT ADDRESS 00041C 


TERM NAME 


LNPAOLT 
LNPAO2T 
LNPAOIS 
LNPAI 
LNPAG 
CLPAOST 
CLPACIT 
TUPAOST1 
TUPACITI 
TUPAOST2 
TUPACIT2 
TUPAOST3 
TUPACIT3 
TUPACIT4G 
TUPAOST4 
TUPACITS 
TUPAO2KI 
TUPAO2K2 
TUPAO2K3 
TUPAO2K4 
CLPAO2K 
TUPAOIKI 
TUPAOIK2 
TUPAOIK3 
TUPAOIK4G 
LNPAO2K 
CLPAOIK 
CLPAO2T 
TUPAO2T2 
TUPAO2T3 
TUPAO2TI1 
CLPAOLT 
TUPAQLTL 
TUPAQIT2 
TUPAOIT3 


HRKKHHKKKXKKXKXKXRXXEND OF SAMPLE REPOR Txcxexxxex xxx reeeen 
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RIB 


8286 
8290 
829A 
&2D4 
837C 
8210 
827D 
8211 
827E 
8212 
827F 
8213 
8280 
&281 
8214 
8282 
824B 
82AC 
82AD 
82AE 
82AA 
82A5 
8246 


8247 


8248 
82A9 
82A4 
8291 
8293 
8294 
8292 
S287 
8288 
8289 
828A 


LIB 
ADDR 


0039 
CO3A 
0026 
0025 
0029 
O02E 
0038 
OO2E 
0038 
OO2E 
0038 
OO02E 
0038 
0038 
OO2E 
0038 
OO3E 
OO3E 
OO3E 
OO3E 
OO3E 


_003D 


003D 
003D 
003D 
OO3E 
003D 
003A 
OO3A 
003A 
OO3A 
0039 
0039 
0039 
0039 


# I/O OPS 


00000000 
00000000 
60000000 
00000000 
00000000 
00000002 
09000002 
00000000 
CO00COCSO 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000326 
00000000 
06000000 
000060000 
00000096 
60000000 
00000001 
o00000col 
00000000 
00000000 
00000326 
00000894 
OcoodI101 
00000087 
00000261 
00000002 
60000000 
00000000 
009000000 


78 


DEVICE TYPE 3705 


TEMP 


ERRORS 


000000 
oo00ce 
000000 
000000 
oc0000 
000002 
co0002 
co000d 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
000000 
ooco000 
000000 
o0c0000 
000000 
C00COl 
000001 
000000 
000000 
000016 
000040 
000002 
c000c5 
000013 
o0c0b02 
000000 
000000 
090000 


PERM 


ERRORS 


000001 
600001 
000001 
000001 
000001 
000002 
000002 
000001 
000001 
000001 
000001 
000001 
000001 
000001 
600001 
000001 
000011 
000003 
000003 
000003 
000004 
oo0cel 
000001 
000001 
000001 
600003 
000005 
000004 
000003 
000004 
000007 
000002 
000002 
000001 
600001 


TOTAL NUMBER 


OF RECORDS 9079 


HDWR 


90001 
0co0l 
00001 
00001 
00001 
00000 
60000 
00000 
00000 
00000 
60000 
00000 
00000 
00000 
000090 
00000 
00004 
00001 
00001 
00001 
00004 
60000 
00000 
00000 
00001 
00003 
00000 
00000 
60000 
00000 
00000 
00000 
00000 
00000 
60000 


MODEL:-- 0168 


™ OUT 


00900 
00000 
000090 
00000 
00000 
00002 
00002 
00001 
00001 
00001 
00001 
00001 
00001 
00001 
00001 
00001 
0c00u 
oco0e 
oc002 
0c002 
ococo 
00000 
00001 
00001 
00000 
00000 
00005 
00004 
00001 
00001 
00000 
00002 
09002 
03061 
09001 


TOOLS/SERVICE AIDS 


DATA CK 


00000 
00000 
00000 
00000 
o0oco 
00000 
60000 
00000 
00000 
09000 
00000 
00008 
00000 
00000 
00000 
00000 
090000 
00000 
00000 
00000 
oco00 
00000 
00000 
000090 
00000 
60000 
00000 
00000 
00000 
000900 
00000 
00000 
00000 
C0000 
00000 


SERIAL NO. 


RCV 


00000 
00600 
00000 
00000 
00000 
00000 
00c00 
00000 
0c000 
00000 
00000 
00000 
00000 
00060 
00000 
00000 
09007 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
006000 
00000 
00000 
00000 
00000 
00000 
00000 
60090 
60600 
00000 
00600 


060009 


ITV RGD 


00000 
00000 
00000 
00000 
60000 
00000 
00000 
00000 
00000 
00000 
60000 
00000 
60000 
00600 
00000 
00000 
60000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
66000 
00000 
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The parameters used to obtain this sample report limited the output in the I/O section to 3705s, 
DEV=(3705), did not create a history tape ACC=N, and did not zero out SYS1.LOGREC. For a normal 
report, you would include all I/O (no DEV), generate a history tape, ACC=Y, and zero out 
SYS1.LOGREC, ZERO=Y. This report should be run on a daily basis, and the totals scanned to determine 
if there is a problem that requires further analysis. The temporary and permanent error counts 
should be compared to. your trend reports to establish an average error rate for each I/O and system 


component. These daily reports should be retained until a trend report has been run which includes 
the data in this report. 


The parameters used were: 


/7/STEP1 EXEC PGM=IFCEREPI, 

/7 PARM='ACC=N,PRINT=SU,DEV=(3705),TYPE=EOT ' 
7/SYSPRINT DD SYSOUT=A 

//7SERLOG DD DSN=SYS1.LOGREC,DISP=SHR 
/7EREPPT DD SYSOUT=A,DCB=BLKSIZE=133 
7/SYSUDMP DD SYSOUT=A,DCB=BLKSIZE=133 


PAGE 4-94 


Example 3: TRENDS REPORT MDR SAMPLE 


TRENDS REPORT 
(PART 1) 
CPU/CHANNEL/STORAGE/SCP 


JULIAN 78 

DAY 23 24 25 26 27 
IPL 

CPU A 0 0 0 0 0 


MACHINE CHECK 
CPU A 90 0 0 0 0 


CHANNEL CHECK 
CPU A 0 0 0 0 0 


PROGRAM ERROR 
CPU A 90 0 0 a 


CPU MODEL SERIAL NO. 


A 0168 060009 
TRENDS REPORT 
(PART 2) 
I/0 SUBSYSTEM 
JULIAN 78 
DAY 23 24 25 26 27 
TP CNTRL 
3705 
OlIB A 
LINES 
PERM o0.6hU«OetC«SOd 0 I 
TEMP a 0 0 0 
1B A 
LINES 
PERM a | 0.60 C87 
TEMP \ 0 6 «51 
llc A 
LINES 
PERM o 6 6OlUlCOO 0 380 
TEMP 06 OO 66060 6239 


CPU MODEL SERIAL NO. 


A 0168 060009 


6G624-1514-1 


28 


28 


29 


29 


Qo Qo oO 


aQoo 


REPORT DATE 030 78 
PERIOD FROM 027 78 
TO 0630 78 


30 


REPORT DATE 030 78 
PERIOD FROM 027 78 
TO 030 78 


30 


116 


EREP1] INFORMATIONAL MESSAGES 


TOOLS/SERVICE AIDS 


DATE - 030 78 
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INPUT PARAMETER STRING ACC=N ,DEV=(3705),TYPE=EOT,TRENDS=Y ,DATE=( 78023, 78030 ) 


PARAMETER OPTIONS VALID FOR THIS EXECUTION 
RECORD TYPES(OBR,EOD,MDR),TREND REPORT,LOGREC INPUT,DUMP SDR COUNTERS 
DATE/TIME RANGE - 78023, 78030/00000000:24000000 
TABLE SIZE - 024K,LINE COUNT - 050 

DEVICE ENTRIES 
DEVICE TYPESCOBR ,MIH,DDR )-3705(4035 ) ,3705(4025),3705(4015),3705(4005 ) 
DEVICE TYPESCMNDR }-3705(05) 

IFC120I1 0 RECORDS SAVED FOR TREND PARTI 

IFC1201 656 RECORDS SAVED FOR TREND PART2 


HHH HH HHH KHMINRMHRHKKHEND OF SAMPLE RE POR 1363636363 36H HIN 


The JCL used to run this sample used SYS1.LOGREC instead of a history tape. For a customer system, 
the trend report would be run using the history tape or tapes for input instead of logrec. The 
parameters to do this would be ,HIST=Y, in the PARM statement and a //ACCIN DD statement defining 
where the accumulation dataset is. The trend report should be used to determine the day to day 
operation of your system. Retaining a copy of the trend report in a history book will allow you to 
establish an average level of line errors and a normal level of system problems. If the error levels 
start to rise, using trend will enable you to determine what type of action needs to a taken before 


the errors reach the point of impacting your system operations. 
The parameters used were: 


77STEP1 EXEC PGM=IFCEREPI, 

77 PARM=' ACC=N,DEV=( 3705) ,TYPE=CDEHINOST, TRENDS=Y »,DATE=( 78023, 78030 )' 
77SYSPRINT DD SYSOUT=A 

/7/SERLOG DD DSN=SYS1.LOGREC,DISP=SHR 

77EREPPT DD SYSOUT=A,DCB=BLKSIZE=133 

//SYSUDMP DD SYSOUT=4,DCB=BLKSIZE=133 
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Example 4: PERMANENT LINE ERRORS FOR BSC & S/S MDR SAMPLE 


~-~RECORD ENTRY TYPE - 3705 MDR 
VS 2 REL. 03 


SOURCE - OUTBOARD 


DAY YEAR HH MM SS.TH 

DATE- 256 78 TIME 04 53 09 59 
DEVICE TYPE 3705 
CHANNEL UNIT ADDRESS OO1A 
RESOURCE I.D. 8401 


RECORD TYPE ~- BSC/SS PERMANENT LINE ERROR 
LIB ADDR. 0048 
TERMINAL NAME LNPA1LOT 

BASIC TRANSMISSION UNIT 
BTU COMMAND 00 

BTU MODIFIER 00 

BTU FLAGS 0000 


IOB COMMAND 8D 
IOB MODIFIERS 0000 
IOB IMMED CTL CMMND 00 


INITIAL ERROR STATUS 00 
FIRST BYTE 


INITIAL ERR EXT STAT 00 


EXTENDED ERR STAT FLG 0 OVERRUN/UNDERRUN FLAG 0 EXTENDED ERR STAT FLG 0 OVERRUN/UNDERRUN FLAG 0 
FORMAT EXCEPTION FLAG 0 LINE QUIET TIMEOUT FG 0 FORMAT EXCEPTION FLAG 0 LINE QUIET TIMEOUT FG 0 
SYNC CHECK FLAG 0 LEADING DLE FORMAT CH 0 SYNC CHECK FLAG 0 LEADING DLE FORMAT CH 0 
DATA CHECK FLAG 0 SUB BLOCK ERROR FLAG 0 DATA CHECK FLAG 0 SUB BLOCK ERROR FLAG 0 
PH ER 6 UNUSED 0 PH ER 0 UNUSED 0 
45 RO 0 UNUSED 0 AS RO 1 UNUSED 0 
E R 0 UNUSED 0 E I UNUSED 0 
LENGTH CHECK FLAG 0 UNUSED 0 LENGTH CHECK FLAG 0 UNUSED 0 
SIO COUNTER 0000 TEMPORARY ERROR COUNTER 00 
2770 00 
HEX DUMP OF RECORD 
HEADER 91830800 O058A0000 0078256F 04530959 01060009 01680588 
0018 OO1AD3D5 D7CIFI1FO E3408401 004B0005 60000000 8_D000000 06F40000 0o0cc0c00 
0038 00060000 00010000 60000000 00000000 00000000 0000 


HKHHHAKKRHKKHHKKHHKEND OF SAMPLE RE POR THK 
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MODEL- 0168 


SERIAL NO. 060009 


IOB INITIAL ERROR STATUS 0000 
IOB INITIAL ERR EXT STAT 00 
IOB STATUS 
IOB EXTENDED STATUS 
LAST ERROR STATUS 06 
FIRST BYTE 


O6F4 
00 
LAST ERR EXT STAT 00 
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I03 COMMAND 


Write initial. 


Write continue. 


Write recover. 
Write delay. 
Write. 

Read. 

Read delay. 
Read initial. 
Read continue. 
Disable. 
Enable. 

Dial. 

Write EOT. 
Write control. 
Read status. 
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MEANING OF THE DATA FIELDS TO LOOK AT 


IOB STATUS AND INITIAL STATUS BY 
READ/KRITE GROUP 


No errors. 

Recetve text. 

Receive text reply. 

Receive control; command reject. 
Status outstanding when command 
issued; command not executed. 
Send text reply. 

Send text. 

Send control. 


DATA SET CONTROL GROUP 


No errors. 

Recive ID. 

Receive ID reply. 

Connect. 

Status outstanding when command 
issued. 

Error in dialing phase. 

Send ID. 

Disconnect. 
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I0B STATUS AND INITIAL STATUS BYTE 1 
HARDWARE/USER ERROR 


User error, normally indicates an incorrect NCP generation 
Level 1 communication check. 

Communications line adapter check. 
Communications scanner adapter feedback check. 
Equipment check. 

Modem error, modem check bit in SCF field of ICN. 
Modem transmit clock or clear-to-send error. 
DSR-on check, dataset ready did not come up. 
DSR-off check, dataset ready did not go down. 

ACU check, autodial problem. 

Program failure. 


These MDR records are logged by terminal (TERMINAL NAME LNPAI1OT) and using the IOB COMMAND and the 


IOB ERROR STATUS fields. This should help to determine if the error is something you can correct 
yourself. 


For certain errors (e.g.» Timeouts, Modem Interface error, etc.) EREP analyzes the STATUS fields and 


prints the error below the 'RECORD TYPE' field. In this example, 'BSC/SS PERMANENT LINE ERROR' is 
printed. 


The DEVICE TYPE, CHANNEL UNIT ADDRESS, RESOURCE I.D., LIB ADDR.» and TERMINAL NAME fields allow you 
to identify the 3705 and the TP line experiencing trouble. In the above example the IOB command is 
8D, which is an enable command. The IOB status is O06F4, the 06 would be in the dataset control group 
because the command is an '‘'ENABLE', therefore O6=CONNECT. the second byte is an F4 which is a 
DSR-on check. Looking up near the top, we see the LIB address is 004B. 


Using the Teleprocessing Installation Record for IBM 3704 and 3705 Communications Controllers 
{G6C30-3021) and looking up which dataset is connected to 004B we can determine where to look to find 
out if the dataset did not bring up DSR or the 3705 could not recognize that DSR was up. This MOR 


detail would be run when it had been determined from the System Summary report or from the operator 
there was a problem. 


If you already knew what the address or terminal name was, it would reduce the system time and the 
amount of paper printed to specify the LIB address or terminal name by using these additional param- 
eters "DEV=(3705),LIBADR=004B' for LIB address or 'DEV=(3705),TERMN=LNPALOT' for the terminal name. 


The parameters used were: 


//STEP1 EXEC PGM=IFCEREPI, 

/7 PARM=' ACC=N,DEV=(3705),TYPE=EOT,PRINT=PS' 
//SYSPRINT DD SYSOUT=A 

/7SERLOG DD DSN=SYS1.LOGREC,DISP=SHR 
//EREPPT DD SYSOUT=A,DCB=BLKSIZE=133 
//SYSUDMP DD SYSOUT=A,DCB=BLKSIZE=133 
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Example 5: PERMANENT SDLC LINE ERROR MDR SAMPLE 


~--RECORD ENTRY TYPE - 3705 MDR SOURCE - OUTBOARD MODEL~ 0168 SERIAL NO. 060009 
VS 2 REL. 03 
DAY YEAR HH MM SS.TH 

DATE~- 027 78 TIME 04 55 20 93 
DEVICE TYPE 3705 
CHANNEL UNIT ADDRESS 0118 
RESOURCE 1I.D. AO7F 
NETWORK ADDRESS AO7F NETWORK NAME LNDET 


RECORD TYPE - PERMANENT SDLC LINE ERROR 
SUSPECTED MODEM INTERFACE ERROR 

LIB ADDR 0030 

LINK INFORMATION 


CCB TYPE CONNECTION FLG 00 LXB COMMAND 8D LXB LAST ERROR STATUS 06F4 


CCB TYPE FLAGS 31 LXB MODIFIERS 0000 LXB LAST ERR EXT STATUS 00 
LXB IMMED. CTL CMD. 00 LXB FIRST ERROR STATUS 0000 
LXB FIRST ERR EXT STATUS 00 

LAST ERR BIT DECODE LAST ERR EXT STAT FIRST ERR BIT DECODE FIRST ERR EXT STAT 
EXTENDED ERR STAT FLG 0 OVERRUN/UNDERRUN FLAG 0 EXTENDED ERR STAT FLG 0 OVERRUN/UNDERRUN FLAG 0 
FORMAT EXCEPTION FLG 0 BLOCK OVERRUN 0 FORMAT EXCEPTION FLG 0 BLOCK OVERRUN 0 
CHAR SYNC CHECK 0 ABORT 0 CHAR SYNC CHECK 6 ABORT 0 

DATA CHECK 0 MONITOR COUNT OVERFLO 0 DATA CHECK 0 MONITOR COUNT OVERFLO 0 
SDLC POLL FINAL BIT 9 SDLC POLL FINAL BIT 9 


HEX DUMP OF RECORD 


HEADER 91830806 05840000 007802 7F 04552093 01060009 01680588 
6018 O11BD305 C4C5E340 404040 7F 00300205 60000000 &bo00000d 06F40000 00000000 
0038 00000000 00600000 00000031 00000000 00000000 000000 


HHH KKH KHHRHIKXEND OF SAMPLE RE POR THK 


MEANING OF THE DATA FIELDS TO LOOK AT 


LXB COMMAND LXB STATUS AND INITIAL STATUS BYTE 0 
meaning by bit .... ...1 bit 7 on 


00 No I/O occurred. Lex 
30 Run SDLC link. Pe 
32 Run initial (remote nep) 

83 Disable. eiak 
8D Enable. ee 
8F Dial. 


see? 
eetee 
eee 
ee eo @ 
eo@eee 


e*eese 


eee 


FORMAT EXECPTION FLG -INVALID SDLC 


OE Rec REJ, line is not duplex. 
1C Rec RR or in NS phase. 

1E Rec XID in RR or RNR phase. 
A2 Ree invalid SDLC command. 

AS Rec SDLC DISC. 

AC Rec RQI 

B2 Rec SDLC SNRM. 

B6 Rec SDLC ROL. 

BC Rec NSA in RR or RNR phase. 
BD Sent SNRM did not rec NSA. 
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eee. SEE extended error status 

oees Format exception-invalid 
SDLC format. 

---. FCS error (data check). 

000. No command active. 

001. SDLC I-format sent or RR sent 

010. SDLC RNR sent. 

011. SDLC NS command sent. 


100. Transmit. 


101. Error while sending text. 
110. Error while sending normal 
polling or response S-format. 


111. Error while sending NS control 


sequence. 


FORMAT 


TOOLS/SERVICE AIDS 


LXB STATUS AND INITIAL STATUS BYTE 1 
HARDWARE/USER ERROR 


Communications line adapter check. 
Communications scanner adapter feedback check. 
Modem error, modem check bit in SCF field of ICW. 
Modem transmit clock or clear-to-send error. 
DSR-on check, dataset ready did not come up. 
DSR-off check, dataset ready did not go down. 
ACU check, autodial problem. 

Program failure. 


PAGE 4-101 


G6G624-1514-1 ACF/SNA SYSTEM PROBLEM DETERMINATION GUIDE Vol. I 


These MDR records are logged by network (NETWORK NAME LNDET) and using the LXB COMMAND and the LXB 
ERROR STATUS fields should enable you to determine if the error is something you can correct your- 
self. In the case of some errors (i.e., Timeouts, Modem Interface error, etc.) EREP will analyze the 
STATUS fields and print the error below the ‘RECORD TYPE' field. In this example, ‘SUSPECTED MODEM 
INTERFACE ERROR' is printed. 


The DEVICE TYPE, CHANNEL UNIT ADDRESS, RESOURCE I.D., LIB ADDR.» and NETWORK NAME fields will allow 
you to identify the 3705 and line with trouble. In the example above, the LXB command is 8D which is 
an enable command. The LXB status is 06F4, the 06 would mean SDLC NS command sent. The second byte 
is an F4 which is a DSR-on check. Looking near the top we see the LIB address is 0030. 


Using the installation guide (GC30-3021)} and looking up which dataset is attached to 0030, we can 
find out where to look to find out if the dataset did not bring up DSR or the 3705 could not recog- 
nize that DSR was up. This MDR detail would be run when it had been determined from the System Sum- 
mary report or from the operator there was a problem. 


If you already knew what the address or terminal name was, it will reduce the system time and the 
amount of paper printed to specify the LIB address or terminal name by using these additional param- 
eters ‘DEV=(3705),LIBADR=0030' for LIB address or 'DEV=(3705),TERMN=LNDET' for the terminal name. 


The parameters used were: 


//7STEPI EXEC PGM=IFCEREPI; 

7/7 PARM=' ACC=N,;,DEV=(3705),TYPE=EOT,PRINT=PS' 
//SYSPRINT DD SYSOUT=A 

//7SERLOG DD DSN=SYS1.LOGREC,DISP=SHR 
/7EREPPT DD SYSOUT=A,DCB=BLKSIZE=133 
//SYSUDMP DD SYSOUT=A,DCB=BLKSIZE=133 
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Example 6: SDLC STATION ERROR MDR SAMPLE 


FINAL ERR BIT DECODE 


EXTENDED ERR STAT FLG 0 OVERRUN/UNDERRUN FLAG 0 EXTENDED ERR STAT FLG O OVERRUN/UNDERRUN FLAG 0 

FORMAT EXCEPTION FLG 0 BLOCK OVERRUN 0 FORMAT EXCEPTION FLG 0 BLOCK OVERRUN 0 
0 ABORT 0 0 ABORT 0 

DATA CHECK 0 MONITOR COUNT OVERFLO 0 DATA CHECK 0 MONITOR COUNT OVERFLO 0 

SDLC POLL FINAL BIT 0 SDLC POLL FINAL BIT 0 

LOCAL PRI STATION INFORMATION 

SCB STATION TYPE 02 

SCB SERV. SEEKING CMD FLGS 0001 

SCB OUTPUT CONTROL FLAGS CO 

XNTD BLU CMD FLD 00 

RCVD BLU CMD FLD 31 

NCR) 02 

N(S) 07 

SCB CRNT OUTSTANDING CNT 000 

SCB PASS COUNT 007 

SCB I-FORMAT TRANSMIT CNT 000008 

SCB RETRY COUNT 037 

REX DUMP OF RECORD 

HEADER 91830800 058A00D5 0078256F 10131068 01060009 01680588 

0018 O41CD7E4 D7CLF2ES 40408315 00270305 0001C000 30000000 02800002 80000008 
00338 25310000 02000007 4GEE0021 00000002 D3D5D7C1 F2404040 00000000 oo000000 


FINAL ERR EXT STAT 


HHIKHHKIH IKK KKHHHXHXEND OF SAMPLE REPOR Tx xxx xe xe 
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---RECORD ENTRY TYPE - 3705 MDR SOURCE - OUTBOARD MODEL- 0168 SERIAL NO. 060009 
VS 2 REL. 03 
DAY YEAR HH MM SS.TH 
DATE- 256 78 TIME 10 13 10 68 
DEVICE TYPE 3705 
CHANNEL UNIT ADDRESS 041C 
RESOURCE I.D. 8315 
NETWORK ADDRESS 8315 NETWORK NAME PUPA2Z 
RECORD TYPE - PERMANENT SDLC STATION ERROR 
TIME-OUT, NOTHING RECEIVED 
LIB ADDR 0027 
LINK INFORMATION 
CCB CONTROL FLG 00 LXB COMMAND 30 LXB FINAL ERROR STATUS 
CCB LINE TYPE 21 LXB MODIFIERS 0000 LXB FINAL ERR EXT STATUS 
LXB IMMED. CTL CMD 00 LXB INITIAL ERROR STATUS 


LXB INITIAL ERR EXT STATUS 


INITIAL ERR BIT DECODE 


TOOLS/SERVICE AIDS 


INITIAL ERR EXT STAT 
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MEANING OF THE DATA FIELDS TO LOOK AT 


LXB COMMAND LXB STATUS AND INITIAL STATUS BYTE 0 LXB STATUS AND INITIAL STATUS BYTE 1 
meaning by bit (.... ...1)= bit 7 on HARDWARE/USER ERROR 
06 No I/O occurred. 1... .... see extended error status 
30 Run SDLC link. -1l.. «2... Format exception-invalid E8 Communications line adapter check. 
32 Run initial Cremote nep) SDLC format. EA Communications scanner adapter feedback check. 
83 Disable. ool ...- FCS error (data check). FO Modem error, modem check bit in SCF field of ICH. 
8D Enable. eee 000. No command active. F2 Modem transmit clock or clear-to-send error. 
8F Dial. eee OOL. SDLC I-format sent or RR sent F4 DSR-on check, dataset ready did not come up. 
-es. 010. SBLC RNR sent. F8 OSR-off check, dataset ready did not go down. 
SCB DEVICE TYPE eeee O11. SDLC NS command sent. FC ACU check, autodial problem. 
oes. 100. Transmit. FF Program failure. 
Meee ees L=Duplex station »ee- 101. Error while sending text. 
O= Half duplex oee- 110. Error while sending normal 
ool. .... Switched SDLC polling or response S-format. 
ooee ole. Terminal node oee- lll. Error while sending NS control 
esee eel. Cluster node sequence. 


coos e+ XX L=Intermediate node 
O=Boundary node 


FORMAT EXECPTION FLG-INVALID SDLC FORMAT SCB LINK SCHEDULING FLAGS 
CE Rec REJ, line is not duplex. BYTE 0 BITS. SERVICE SEEKING COMMANDS. BYTE 1 BITS. CONTACT POLL COMMANDS. 
1C Rec RR or in NS phase. 
1E Rec XID in RR or RNR phase. 1... «2... Poll skip flag. 1... .... Disconnect (DISC). 
A2 Rec invalid SDLC command. -l.. .... Halt service seeking. -l.. .... Set Normal Response mode (SNRM). 
A8 Rec SDLC DISC. — ,el. ...- Not operational. coos oL.. Set Initialization mode (SIM). 
AC Rec RQI eeee eee Contact poll command eoee ood. Exchange Identification (XID). 
B2 Ree SDLC SNRM. active. wees 02eX Contact poll command field. 


B6 Rec SDLC ROL. 
BC Rec NSA in RR or RNR phase. 
BD Sent SNRM did not rec NSA. 


These MDR records are logged by network (NETNORK NAME PUPA2Z) and using the LXB COMMAND and the LXB 
ERROR STATUS fields should enable you to determine if the error is something you can correct your- 
self. In the case of some errors (i.e., Time Outs, Modem Interface error. etc.) EREP will analyze 
the STATUS fields and print the error below the 'RECORD TYPE' field. In this example, ‘TIMEOUT, 
NOTHING RECEIVED’ is printed. The DEVICE TYPE, CHANNEL UNIT ADDRESS; RESOURCE I.D., LIB ADDR., and 
NETWORK NAME fields will allow you te identify the 3705 and line with trouble. 


In the example above the LXB command is 30 which 31s RUN SDLC LINK. The LXB status is 0280, the 02 
would mean SDLC I-format sent or SBDLC RR sent. The second byte is an 80 which indicates Time-out: 
nothing received. Looking near the top we see the LIB address is 0027 so using the pre-installation 


guida and looking up which device/station is attached to 0027, we can run the appropriate tests to 
determine the status of the device/station. 


This MOR datail would be run when it had been determined from the System Summary report or from the 
operator there was a problem. If you already knew what the address or terminal name was it would 
reduce the system time and the amount of paper printed to specify the LIB address or terminal name 
by using these additional parameters »>DEV=(3705),LIBADR=0027, for LIB address or 
DEV=(3705),TERMN=PUPA2Z, for the terminal name. 


The parameters used were: 


//7STEPL EXEC PGM=IFCEREPI, 

77 PARM='ACC=N,DEV=(3705),TYPE=EOT,PRINT=PS' 
//7SYSPRINT DD SYSOUT=A 

7/7SERLOG DD DSN=SYS1.LOGREC,DISP=SHR 
77EREPPT DD SYSOUT=A,DCB=BLKSIZE=133 
/7SYSUDMP DD SYSOUT=A,DCB=BLKSIZE=133 


GG624-1514-1 TOOLS/SERVICE AIDS 


PAGE 4-105 


- 6624-1514-1 


Example 7: BSC STATION STATISTICS MDR SAMPLE 


-~~-RECORD ENTRY TYPE ~- 3705 MDR 
VS 2 REL. 03 


SOURCE - OUTBOARD MODEL~- 0168 


DAY YEAR 
DATE- 033 78 


HH MM SS.TH 
TIME 19 01 28 77 


DEVICE TYPE 3705 
CHANNEL UNIT ADDRESS 0115 


RESOURCE 1.D. A004 
LIB ADDR. 6020 
TERMINAL NAME DE2 


BASIC TRANSMISSION UNIT 
BTU COMMAND 00 

BTU MODIFIER 00 

BTU FLAGS 0000 


IOB COMMAND 00 
IOB MODIFIERS 0000 


IOB IMMED CTL CMMND 00 IOB STATUS 


IOB EXTENDED STATUS 


INITIAL ERROR STATUS 090 INITIAL ERR EXT STAT 00 
FIRST BYTE 
EXTENDED ERR STAT FLG 0 


FORMAT EXCEPTION FLAG 0 


LAST ERROR STATUS 00 
FIRST BYTE 

EXTENDED ERR STAT FLG 0 

FORMAT EXCEPTION FLAG 0 


OVERRUN/UNDERRUN FLAG 0 
LINE QUIET TIMEOUT FG 0 


SYNC CHECK FLAG 0 LEADING DLE FORMAT CH 0 SYNC CHECK FLAG 6 LEADING OLE FORMAT CH 90 
DATA CHECK FLAG 0 SUB BLOCK ERROR FLAG 0 DATA CHECK FLAG 0 SUB BLOCK ERROR FLAG 0 
PH ER 0 UNUSED 0 PH ER 0 UNUSED 0 
AS RO 0 UNUSED 0 AS RO 0 UNUSED 0 
E R 0 UNUSED 0 E R 0 UNUSED 0 
LENGTH CHECK FLAG 0 UNUSED 0 LENGTH CHECK FLAG 0 UNUSED 0 
SIO COUNTER 03C6 TEMPORARY ERROR COUNTER 00 
2770 00 
HEX BUMP OF RECORD 
HEADER 91830800 058A0000 0078033F 19012877 01060009 01680588 
0018 O11BC4C5 F2404040 4040A004 00200105 00000000 00000000 00000000 000003C6 
0038 00001007 4C3C407E 601DE8C3 D6 


HHH KK HKKHHRXXEND OF SAMPLE RE POR T2¢226263636 3696369696969 
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IOB INITIAL ERROR STATUS 
IOB INITIAL ERR EXT STAT 00 


SERIAL NO. 060009 


LAST ERR EXT STAT 00 


OVERRUN/UNDERRUN FLAG 0 
LINE QUIET TIMEOUT. FG 0 
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This type of record gives a count of the number of Start Input/Output operations (SIO), and the num- 
ber of temporary errors that occurred by terminal. 


There will be a record recorded whenever one of the counters overflows. The overflow records are 
identified by the fact that there all zeros in the status fields and IOB command field. The LIB addr 
and the terminal name identify the terminal (0020 and DE2). The number of Start I/Os count is 'SIO 
CNTR 003C6', and the error counter is ‘TEMPORARY ERR CNTR 00'. 


The parameters used were: 


/7STEP1 EXEC PGM=IFCEREP1, 

77 PARM=" ACC=N,DEV=(3705),TYPE=EOT,PRINT=PS, TERMN=LLEAS71K' 
//SYSPRINT DD SYSOQUT=A 

//SERLOG OD DSN=SYS1.LOGREC,DISP=SHR 

/7EREPPT DD SYSOUT=A,DCB=BLKSIZE=133 

//7SYSUBDMP DD SYSOUT=A,DCB=BLKSIZE=133 

(¥* 
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Example 8: COMMUNICATION SCANNER MDR SAMPLE 


--~RECORD ENTRY TYPE - 3705 MDR 


VS 2 REL. 


DEVICE TYPE 
CHANNEL. UNIT 


RESOURCE I.D. 


03 | 
DAY YEAR 
DATE- 002 78 
3705 
ADDRESS OO1A 
9000 


SOURCE - OUTBOARD 


TYPE 2 CRECORD TYPE - UNKNOWN - IFCETRNI 


RECORD TYPE - COMMUNICATION SCANNER TYPE 
LAGGING ADDRESS REG 74 OOOO1LIDE 
EXTERNAL REGISTER 79 0043 


COMMUNICATIONS SCANNER STATUS 43= 


LIB 
LIB 
LIB 
LIB 
LIB 
LIB 


LIB 


ICW 


ICW 


POS 1 BIT CLOCK CHECK 
POS 2 BIT CLOCK CHECK 
POS 3 BIT CLOCK CHECK 
POS 4 BIT CLOCK CHECK 
POS 5 BIT CLOCK CHECK 
POS 6 BIT CLOCK CHECK 


SELECT CHECK 
IN REGISTER CHECK 


WORK REGISTER CHECK 


PRIORITY REGISTER AVAILABLE CHECK 


CCU 


OUTBUS CHECK 


LINE ADBUS CHECK 


UNUSED 


UNUSED 


HEX DUMP OF RECORD 


HEADER 918308006 058A0000 


0018 OO1AD5C3 D7C14040 


0060002F 


40409000 


2 CSB1 


eooo oo 


HH MM SS.TH 
TIME 08 13 52 39 


MODEL- 


ABEND CODE 0000 


INTERRUPTED LEVEL IAR 


0200 


08135239 


00001105 


HRUR KKK KKKKKXKHXXEND OF SAMPLE RE POR Tx 30332 HIEN 


01060009 


40600200 


0168 


COOO1ILE2 


01680588 


OOOO1IDE 


SERIAL NO. 


OOOOLIE2 
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060009 


00430000 


This was a sample of the type of record that would print out if MDR had logged any errors for the 
3705. Other types of detail records for the 3705 are: 


® Type 1/4 channel errors 
® Type 2/73 channel errors 
¢ Type 1 communication scanner 
® Type 3 communication scanner 
® Input/Output instruction exceptions 
® Unresolved Program level 1 interrupt requests 
® Unresolved program level 3 interrupt requests 
® Invalid instruction operation code check 
® Address exception 
® Protection check 
® branch to zero by level 5. 
The parameters used were: 
//STEPI1 EXEC PGM=IFCEREPI, 
//7 PARM='ACC=N,DEV=(3705),TYPE=EOT,PRINT=PS' 
//7SYSPRINT DD SYSOUT=A 
/77SERLOG DD DSN=SYS1.LOGREC,DISP=SHR 


/7EREPPT DD SYSOUT=A,DCB=BLKSIZE=133 
/7SYSUDMP DD SYSOUT=A,DCB=BLKSIZE=133 
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Example 9: LINE SUMMARY RECORD MDR_ SUMMARY 
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~-~-SUMMARY OF ENTRY TYPE - 3705 MDR 
DAY YEAR 


DATE RANGE- 02 


7 78 TO 030 


DAY YEAR 


78 


CHANNEL UNIT ADDRESS 00001B 


T.P.LINE ERRORS 


PERM. SDLC LINE ERRORS 


CHANNEL ADAPTER TYPE1 ERRORS 
CHANNEL ADAPTER TYPE2 PORT1 
CHANNEL ADAPTER TYPE2 PORT2 


COMMUNICATIONS 
COMMUNICATIONS 
COMMUNICATIONS 
COMMUNICATIONS 
COMMUNICATIONS 
COMMUNICATIONS 
COMMUNICATIONS 
COMMUNICATIONS 
COMMUNICATIONS 


SCANNER 
SCANNER 
SCANNER 
SCANNER 
SCANNER 
SCANNER 
SCANNER 
SCANNER 
SCANNER 


TYPE] 
TYPE2 
TYPE2 
TYPE2 
TYPE2 
TYPES 
TYPE3 
TYPE3 
TYPE3 


0002 
0000 
c0c0 
0000 
0000 


CSBI 
CSB2 
CSB3 
CSB4 
CSB1 
CSB2 
CS53 
CSB4 


0000 
0022 
0000 
0000 
0000 
0000 
0000 
0000 
0000 


DEVICE TYPE 3705 MODEL- 60168 


TOTAL NUMBER OF RECORDSOOO2 


ADDRESS EXECPTION CHECK 0000 
IN/OUT CHECK 0000 
PROTECTION CHECK 0000 
INVALID OP CODE CHECK 0000 


MISCELLANEOUS PROGRAM LEVEL 10000 
MISCELLANEOUS PROGRAM LEVEL 30000 


HH HMM HHH HR MHKHKKNXXEND OF SAMPLE REPOR T2036 2¢363¢2¢363¢263¢ 326263 


SERIAL NO. 060009 


PAGE 4-119 


The MOR summary record will print one record for each line or terminal that has logged one or more 
MDR records in SYS1.LOGREC. The summary records print when the PRINT parameter is PS (print full 
record and summary), or SU (print summary only). 


In the above summary, there are three major areas that you should look at to determine if there are 
any problems that will require action on your part or if you require CE service from IBM. 


The first area is the area labelled CHANNEL ADAPTER and COMMUNICATIONS SCANNER. If there are error 
counts in either category (such as the count of 0022 for SCANNER TYPE2 CSB1}, you have a hardware 
problem. Print an EREP1 detail for the 3705 and call IBM for service. 


The second area is the section that has the CHECKS and MISC. PROGRAM LEVELs. If there is a count in 
any of these fields, you have a software or hardware 3705 problem and should call IBM for a PSR to 
look at the problem. Note that on the two lines labelled MISCELLANEOUS PROGRAM LEVEL, there is no 
space between the level and the four digits for the count. (10000 is level 1 count of zero.) 


The third area is the group with lines labeled LINE ERRORS. If the count for either of the two line 
types are abnormally high, you are having problems that are showing up as line errors. The line 


errors may be due to a 3705 problem (sending bad data), a dataset problem, a line problem, or a ter- 
minal problem. 


To determine what the problem is, you should print the EREPL detail record for that 3705 to deter- 
mine if the problem is a 3705, or line-related problem. If the errors point to various lines, it 
probably is a 3705 problem. 


If the errors are on one line, you should look at the commands and status fields (for more tnforma- 


tion on permanent line errors, see the MDR records on line errors) in the MDR records and you may 
have to run a line trace. 


The parameters used were: 


“/STEPL EXEC PGM=IFCEREPI, 

/7 PARM='ACC=N,DEV=(3705),TYPE=EOT,PRINT=PS, TERMN=LLEAS7I1K" 
//SYSPRINT DD SYSOUT=A 

//SERLOG DD DSN=SYS1.LOGREC,DISP=SHR 

77EREPPT DD SYSOUT=A4,DCB=BLKSIZE=133 

/7SYSUDMP DD SYSOUT=A,DCB=BLKSIZE=133 
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Example 10: END OF DAY RECORD MOR SUMMARY 


~-- RECORD ENTRY TYPE - UNIT CHECK SOURCE VTAM OUTBOARD MODEL- 0168 SERIAL NO. 060009 
VS 2 REL. 03 
DAY YEAR HH MM SS.TH JOB IDENTITY 
DATE- 033 78 TIME 19 00 34 89 9000000000000000 
DEVICE TYPE NONE 


PRIMARY CHANNEL UNIT ADDRESS OOOO1A 
ALTERNATE CHANNEL UNIT ADDRESS OOOO1A 


cc DA FL CT K CA US CS CT 
FAILING CCW 060 000000 090 00 0000 CSW 00 000000 900 00 0000 
UNIT STATUS CHANNEL STATUS 
ATTENTION 0 PRGM-CTLD IRPT 0 
STATUS MODIFIER 0 INCORRECT LENGTH 0 
CONTROL UNIT END 0 PROGRAM CHECK 0 
BUSY 0 PROTECTION CHECK 0 
CHANNEL END 0 CHAN DATA CHECK 0 
DEVICE END 0 CHAN CTL CHECK 0 
UNIT CHECK 6 I/F CTL CHECK 0 
UNIT EXECPTION 0 CHAINING CHECK 0 
SENSE BYTE DATA STATISTICAL DATA 
INITIAL FAILURE FINAL RETRY 
BYTE 0 00000000 BYTE 0 00000000 3270 3270 
CMND REJ 0 CMND REJ 0 READ DC 000 WRITE DC 000 
INTV REQD 0. INTV REQD 0 INTV REQD 000 BUS OUT 060 
BUS O CHK 0 BUS O CHK 0 EQUIP CHK 000 NOT USED 000 
EQUIP CHK 0 EQUIP CHK 0 CNTL CHK 000 NOT USED 000 
DATA CHK 0 DATA CHK 0 NOT USED 000 NOT USED 000 
UNIT SPEC 0 UNIT SPEC 0 NOT USED 000 DATA CHK US 000 
CNTL CHK 0 CNTL CHK 0 INT REQ US 000 INTREQ EC US 000 
OPRTN i) OPRTN 0 EQ US 000 
RESOURCE NAME JOB IDENTITY NCPA RECORDING MODE *END OF DAY 
INITIAL SELECTION 0 
SIO CNTR 00024 TEMPORARY ERR CNTR 00000 
COMMAND CODE 1 00 COMMAND CODE 2 00 
HEX DUMP OF RECORD 
HEADER 36830840 00000000 0078033F 19003489 01060009 01680588 
0000 o0000000 00000000 letetetesetels) 00000000 60000000 00000000 O200001A 50004015 
0020 O000001A 00000000 001806000 00002000 D5c3p7Cl 40404040 00000000 00000000 


0640 00000000 0000 


HWHKHM KH KHHKKKHRHKXEND OF SAMPLE RE POR T2633 2636336 


This OBR record is used to log the SIO and TEMPORARY ERROR counters for each line that has a count 
in either of the counters. The SIO counter shows the number of Start I/Os for that line. The Tempo- 
rary Error counter has a count of the number of times that the Error Recovery Program was used to 


recover from a temporary error, if the error was unrecoverable there will be an MDR record for that 
permanent error. 


The parameters used were: 


//STEP1 EXEC PGM=IFCEREP1, 

/7 PARM='ACC=N,DEV=(3705),TYPE=EOT,PRINT=PS,SHORT=Y' 
//SYSPRINT DD SYSOQUT=A 

/77SERLOG DD DSN=SYS1.LOGREC,DISP=SHR 

//EREPPT DD SYSOUT=A,DCB=BLKSIZE=133 

/7/7SYSUDMP DD SYSOQUT=A,DCB=BLKSIZE=133 
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&.4 : TRACES AND DUMPS 


4.4.1 3: TRACES 


DESCRIPTION 


This section discusses when and how to use some of the 
ACF/VTAM traces and provides examples to help interpret 
them. The examples in this section are not in ACF/TAP 
format, however, ACF/TAP formatted trace examples can 
be found in Chapter 6 of the second volume of this 
guide. 


Each ACF/VTAM trace occurs at a different point in the 
network. This allows you to narrow down where the prob- 
lem occurred by following an RU through the network and 
determining where in the network the RU is incorrect, 
out of sequence, or disappeared. 


OPERATION 


To invoke the traces, specify either: 
e MODIFY procname, TRACE, TYPE=nnnn, ID=name 
6 START procname,....» TRACE, TYPE=nnnn,ID=name 


Use the START command to initiate the trace when 
ACF/VTAM is being started. Use the MODIFY command to 
initiate a trace when ACF/VTAM is already running. Both 
commands have additional operands that are unique to 
the type of trace being started. For more information 
about starting the ACF/VTAM traces, see the ACF/VTAM 
Operation Manual (SC27-0612). 


For OS/VS systems, ACF/VTAM passes all trace data to 
OS/VS GTF, which records all the system trace data. 
Therefore, GTF must be active in order to use ACF/VTAM 
traces. See the section on OS/VS GTF in this chapter 
for more information on OS/VS GTF. 
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The BUFFER CONTENTS Trace 


The buffer contents trace can help you determine wheth- 
er a problem is in the host (ACF/VTAM or an application 
program) or in the network. For example, if an appli- 
cation program sends a message to a terminal, and the 
message is correct in the output of the ACF/VTAM buffer 
contents trace, but the message does not appear cor- 
rectly at the terminal, then the problem is probably in 
a system rescurce other than ACF/VTAM or the applica- 
tion program. 


The buffer contents trace records the contents of mes- 
sage buffers in two places: in the application program 
interface (API). and in the transmission subsystem com- 
ponent (TSC). Data sent by an application program gets 
processed by the API first, and then by the TSC. This 
is indicated by an entry of 'USER' in the listing. Flow 
the other way (i.e., from the network to the applica- 
tion) is indicated by an entry of ‘'VTAM' in the 
listing. 


The I/O Trace 

The I/O trace records the order of PIUs flowing between 
network nodes and ACF/VTAM. For example, you might use 
this trace to determine whether an application program 
receives all the replies it should and whether ACF/VTAM 
forwards all the requests issued by the application 
program. 

The contents of the I/O trace are similar to those of 
the buffer trace, except that the I/0 trace records 
less user data. If you do not need this user data, you 
can save trace file space by using the I/O trace. 


You can trace I/O activity for any of the following 
types of nodes: 


© application program 

e PU 

e LU 

® SNA cluster controller 
e NCP 


° SSCP 


e host PU 


e host as an intermediate routing node 
® channel attached major node 
® cross-domain resource 


®  cross-domain resource manager 


The LINE Trace 


The line trace is useful when submitting an APAR on the 
NCP. You might also use this trace if you suspect a 
davice problem. If data appears correctly in the line 
trace but the terminal/printer does not react appropri- 
ately, the terminal/printer itself is probably causing 
the failure. 


The line trace function is shared by ACF/VTAM and the 
NCP. Although the trace is controlled by ACF/VTAM, the 
information in the trace records is gathered by the 
NCP. The NCP sends the data to ACF/VTAM in a PIU. A 
trace type indicator in the PIU indicates whether the 
trace is a byte line trace (type 2 scanner) or block 
line trace (type 3 scanner). 


The TRANSMISSION GROUP Trace 


The TG (transmission group) trace should be used 
instead of a line trace if there is more than one 
active line in a TG, and you do not Know which line is 
causing the problem. The TG trace also shows more data 
than the line trace. 


The TG trace facility traces PIU traffic on a TG as if 
the TG were a single line. The sequence of PIUs traced 
is the sequence of their entry to and exit from the TG, 
not the sequence of actual transmission along the phys- 
ical lines the TG comprises. 


PRINTING 


To print ACF/VTAM trace output (0S/VS systems), use 
either ACF/TAP or the PRDMP service aid. (We suggest 
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TOOLS/SERVICE 


the use of the program ACF/TAP to obtain all the list- 
ings of the GTF traces.) See section 4.4.5. for infor- 


mation about operating ACF/TAP and interpreting the 
output. 


In DOS/VSE systems, the ACF/VTAM trace print utility 
runs as a subtask under ACF/VTAM or as a job step in 
another partition. Therefore, you can start printing in 
one of two ways: 


e use a separate job, whether ACF/VTAM is active or 
not. 


e use the 
MODIFY NET,SUBTASK ,ID=TPRINT ,FUNCTION=ATTACH 
command while ACF/VTAM is active. 


If ACF/VTAM is active when TPRINT is requested, and if 
the trace file is on disk, trace recording is 
suspended. Therefore, either stop the trace or switch 
it to an internal trace table. 


The ACF/VTAM trace utility records trace records in a 
wraparound fashion, either in main storage or in a 
trace file assigned to disk or tape. Therefore, if 
trace data is being produced faster than TPRINT can 
print it, trace data is lost. If the trace file is on 
disk or tape, the operator is notified when the end of 
the trace file is reached. 


REFERENCE MANUALS 


ACF/VTAM OPERATION . ..... - SC27-C6l12 


ACF/VTAM V2 DIAGNOSIS Reference SC27-0621 


e 


ACF/VTAM DIAGNOSIS GUIDE . .. . SC27-0615 (O0S/VS} 
» « « « SC27-0630 (VSE) 
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Following is a list of some of the important traces: -DOS/VSE VTAM Trace 
-ACF/VTAM Internal Trace 
~ACF/VTAM Storage Pool Trace ~ACF/NCP Line Trace 
~ACF/VTAM Buffer Trace ~ACF/NCP Transmisiton Group Trace 


-~ACF/VTAM I/0 Trace 


Listings 


Useful for 
ACF/TAP PRDMP 
| ACF/VTAM Storage Pool Trace cae To monitor the use of VTAM buffers | 
ACF/VTAM Buffer Trace To identify changes in data trans—- 
mitted between 2 nodes. Or appl. 
msg. not appearing on terminal. 
ACF/VTAM I/O rs To see order of IO events between 
3705 and VTAM. 


DOS/VSE | DOS/VSE VTAM Trace Trace Saree oe The uti | The utility program is PDAID. =| ty program is PDAID. 
ACF/VTAM Internal Trace Pienaar ee MM To fix a problem with the VTAM. 


ACF/NCP Line Trace For checking of NCP, line data 
and transmision protocols. 

ACF/NCP TG Trace To check one TG, specially if has se- 
quence and/or protocol problems. 


Figure 10 on page 4-117 shows where traces can be most often used. It also shows how ACF/TAP can be used 
taken. Chapter 6 (SNA Device Flow) shows several exam- to format these traces for analysis. 
ples of an ACF/VTAM Buffer trace, which is one of the 


VTAM Internal Trace 


GTF VTAM 
ACF/TAP e720? @8@# 6888 @ @ 


BUFFERS 


VTAM RNIO Trace 


VTAM BUF Trace VTAM 


Figure 10. Origins Of The Various Traces 


DOS/7VSE_ JOB TO PRINT TRACE 


¢/ JOB TRPRINT 

/7 DLBL TRFILE, 'VSEIPOE.SNA.VTAM.TRACE.FILE' 
/7 EXTENT SYS004,SYSWK1 

// ASSGN SYS004,241 

/f ASSGN SYSLST,O0OE 

/¢ EXEC TPRINT 


Communications 
Scanner 


NCP Line Trace 
NCP TG Trace 


I/O Trace 


SYSLST can be assigned to a printer, tape, or disk with IJSYSLS 
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PAGE 4-118. 
BUFFER CONTENTS TRACE OUTPUT EXAMPLE 
COMMAND : F NET, TRACE, TYPE=BUF, ID=T14022K1 
EXTERNAL TRACE - DD TRACE PAGE 0003 
USRFD FEF ASCB OOFEF3C8 JOBN NCF11 
BUFF T14022K1/NCF11001 LRC( 000,000) OUTBOUND 
VTAM TH=40000012 00000000 OOO00DD0CE 00000008 10000134 OOODOOLE O1D7 RH=0380C0 
F1C21140 7BFOF961 F2FO61F8 F340F1F8 7AF2F77A ¥*1B. #09/20/83 18:27 * 
FS5FO1D60 C1404011 D2FO3CD4 400011D2 FOCSEZE3 ¥*50.-A .KO.M ..KOIST* 
FOF5F4C9 40400961 D640E3D9 CIC3C57E 4GOD6C6C6 *654I I/O TRACE= OFF 
GO6BC2E4 C6C6C5D9 40E3D9C1 C3C57E40 D6D511D4 * ,BUFFER TRACE= ON.M* 
403CD550 00110440 CSEZE3F7 F5F2C940 G4OC7D7E3 * .N&..M IST752I GPT% 
GOESD9C1L C3C540E2 ESCIE3E4 E2407E40 E3D9D9C5 * TRACE STATUS = TRRE* 
E2110550 3CD66000 110550C9 E2E3F1F7 F1C940460 ¥*S.N&.0O-..N&ISTI71I * 
CIC3E3C9 ES5C540E2 CS5E2E2C9 D6D5E240 7EGOFOFO ACTIVE SESSIONS = 00% 
FOFIG0E2 C5E2E2C9 D6D540D9 CS5D8E4C5 E2E3E2G0 %*01 SESSION REQUESTS * 
7EGOFOFO FOF111D6 603CD7FO 0011D6 ¥= 0001.0-.P0..0 % 
| TIME | 66470.673900 
USRFD FEF ASCB OOFEF3C8 JOBN NCF11 
| BUFF NCF11001/T14022K1 LRC(000,000) INBOUND 
VTAM TH=40001012 20008F51 0000000B O0000D00E 1C00000D 0134001E 0003 RH=838000 
TIME 66472.752918 
USRFD FEF ASCB OOFEF3C8 JOBN NCF11 
BUFF NCF1L1001/T14022K1 LRC( 000,000) INBOUND 
VTAM TH=40001012 20000F52 0000000B O000000E 1C00000D 01340008 0013 RH=0390A0 
7DE67A11 E6F08489 42408286 99A46A285 *'W: WOdis bfruse x 
TIME 66514.321921 
USRFD FF1 ASCB OOFEF3C8 JOBN NCF11 
BUFF NCF11001/T14022K1 LRC( 000,000) INBOUND 
USER 7DE67A11 E6F08489 A2408286 99A4GA285 ¥'W: WOdis bfruse % 
‘TIME 66514. 358501 
USRFD FF1 ASCB OOFEF3C8 JOBN NCF11 
BUFF T14022K1/NCF11001 LRC( 000,000) OUTBOUND 
USER F1401140 7BFOF961 F2FO61F8 F340FIF& 7AF2F87A *1 . #09/20/83 18:28 * 
F3FG1D60 C1404011 ESE93CE6 6FOOLIES E9GOLIC1L *34.-A .VZ.W?..VZ .A® 
4DC14040 ¥*(A * 
TIME 66514.689698 
USRFD FEF ASCB OOFEF3C8 JOBN NCF1I1 
BUFF T14022K1/NCF11001 LRC( 000,000) OUTBOUND 
VTAM TH=40000012 00000000 OODODDCE O000000B 10000134 O0ODOOIF 0O2F RH=038040 
| F1G01140 7BFOF961 F2FO61F8& F3G0F1F8 7AF2F87A *1 . #09/20/83 18:28 * 
F3FG1D60 C140G011 ES5E93CE6 6FOOLIES E94G011IC1 ¥*34.-A .VZ.W?..VZ .A® 
: 4DC14040 *CA * 
| TIME 66514.693377 
USRFD FEF ASCB OOFEF3C8 JOBN NCF11 
BUFF NCF11001/T14022K1 LRC( 000,000) INBOUND 
VTAM TH=40001012 20000F53 COCOCO0B OOODDDDE 1C00000D 0134001F 0003 RH=838000 


TIME 66516.785159 


USRFD FF1 ASCB OOFEF3C8 


JOBN NCFII1 


BUFF T14022K1/NCF11001 LRC( 000,000) OUTBOUND 
F1C21140 7BFOF961 FeFO61LF8& F340FIFS 7AF2F87A *1B. #09/20/83 18:28 * 
F3F61D60 C1404011 5SCFO3C5E GO00LI5C FOIDGO5SC *36.-A .*0.5 ..*0.-%* 
40D05C3C6 F1F14040 4040C4C9 E240C2C6 DOEGE2C5 * NCFIL DIS BFRUSEX 
115E401D 603C5F50 6011C14D C1404011 E5616F6F *.3 .-.7&-.A( A .V/22* 


USER 


6FIIE6FO 12404011 40400513 


TIME 66516 .800940 


USRxx Nnn 


ASCB nnnnnnnn(MVS only) - 


JOBN ccccccce 


dddddddd/oon00000 


LRC(xxx, yyy ) 


INBOUND or OUTBOUND 


VTAM or USER 


TH 


RH 
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- identifies the formatting routine (in this example AMDUSRFD). nnn is 


the event ID that represents the buffer contents trace (FEF and FFl 
in this example). 


indicates the address of the ASCB for the address space that created 
the record (OOFEF3C8 in this example). 


indicates the name of the job associated with the address space or 
partition. Re were working with application NCFll. 


- dddddddd indicates the destination of the RU. ooocco00 indicates the 


origin of the RU. The RU was flowing between the terminal (714022K1) 
and the application program (NCF11001). 


indicates the number of records lost since the last trace record was 
written due to the inability of the trace facility to obtain an 
ACF/VTAM buffer. xxx is the destination's lost record count, and yyy 
is the source's lost record count. No records were lost. in this exam- 
ple. 


indicates the direction of the traced data (INBOUND or OUTBOUND) with 
respect to this host subarea. By use of this field and the PIU 


sequence number in the TH, requests and ccrresponding responses can 
be matched. 


- indicates where the message buffers are traced. VTAM means the buffers 


were traced in TSC (Cin which case the TH and the RH are included in 
the trace record). USER means the buffers were traced in API (in 
which case the TH and the RH are not tncluded). 


- indicates the 26-byte transmission header portion of the path informa- 


tion unit (PIU). 


- indicates the 3-byte request/response header portion of the PIU. 
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TIME = nnnnn.nnnnnn - indicates the time, in seconds, that each record was traced. This time 
can be used to determine whether a delay, if one exists, is in the 
application. 


The rest of the trace record shows the contents of the buffer. Each line contains 20 bytes of 
user data in 5 groups of 8 hexadecimal digits folloned by the equivalent 20 EBCDIC characters. 
Confidential data will not be recorded in trace records. 


1/0 TRACE OUTPUT EXAMPLE 


COMMAND : F,NET, TRACE, TYPE=I0,ID=T14022K1 


GG24- 


ASCB OOFEF3C8 CPU 0000 JOBN NCF11 
40001012 20000F95 0000000B O000000E 1C00000D 
TIME 69246 .469800 
ASCB OOFEF3C8 CPU 0000 JOBN NCF1l 
40001012 20000790 O00ODGOE O000000B 10000134 
TIME 69246 . 743733 
ASCB OOFEF3C8 CPU 0000 JOBN NCF11 
40001012 20008F96 0000000B O000000E 1C00000D 
TIME 69248 .532742 
ASCB OOFEF3C8 CPU 0000 JOBN NCF1l1 
40001012 20000791 OOOOOOOE O000000B 10000134 
TIME 69248 .545638 
ASCB OOFEF3C8 CPU 0000 JOBN NCFil 
40001012 20000F97 0000000B OOOOODOE 1C00000D 
TIME 69249.899074 
ASCB OOFEF3C8 CPU 0000 JOBN NCF1l 
40001012 20008792 OO000CDE OCOD00D0B 10000134 
TIME 69252 .397974 
ASCB OOFEF3C8 CPU 0000 JOBN NCF11 
40001012 20000F98 O000000B O000000E 1C00000D 
TIME 69253.345774 
ASCB OOFEF3C8 CPU 0000 JOBN NCF11 
49001012 20000793 OOCCOODE 0000000B 10000134 
TIME 69253.552844 
ASCB OOFEF3C8& CPU 0000 JOBN NCF11 
40001012 20008F99 CO00000B OO0COOOE Ico0000D 
TIME 69254.024283 
ASCB OOFEF3C8&8 CPU 0000 JOBN NCFII1 
40001012 20000F9A COCO000B OO0O0D0E 1CcoO0000D 
TIME 69270.510143 
ASCB OOFEF3C8 CPU 0000 JOBN NCF1I1 
40001012 20000794 OO0CCOOE 0000000B 10000134 
TIME 69270. 706226 


1514-1 


01340010 


00000044 


01340044 


000D0045 


01340045 


000D0046 


01340046 


00000047 


01340047 


01340011 


000D0048 


EXTERNAL TRACE - DD TRACE 


00130390 AD7DE67A 1L1E6FO84 


002F0380 


00038380 


005F0380 


00038380 


00830380 


00078790 


00890380 


00078790 


00090390 


009B0380 


GOF14011 


00 


COFIC211 


00 


COF14011 


00081B00 


COF14011 


OO008IB00 


A0D7DE6FO 


GOFIC211 
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GO7BFOF9 


GO7BFOFS 


00 


407BFOF9 


00 


LIEGFO 


40 7BFOF9 
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RNIO - indicates the trace record was created by the GTF RNIO trace. 

ASCB nnnnnnnn-— - indicates the address of the ASCB (MVS) of the current address space or parti- 
tion when the trace entry was taken. 

CPU nnnn - indicates the ID of the host processor in which the trace was run (applies 
only in a multiprocessor configuration). 

JOBN ccccccce - indicates the name of the job associated with the I/O operation Cin this exam- 
ple NCF11) 

IN/OUT - indicates the direction of the trace record: IN for inbound to ACF/VTAM, and 


QUT for outbound to the specified node. When ISTINN is specified, each RU will 
be traced twice - once when it enters ACF/VTAM (CIN) and once when it leaves 
(QUT). 


TIME nnnnn.nnnnnn - indicates the time, in seconds, that each record was traced. This time can 
be used to determine whether a delay, if one exists, is in the host or 
external (e.g.» NCP). 


The rest of the trace record is some or all of the path information unit (PIU). It consists of a 
26-byte transmission header (TH), a request/response header (RH), and as much of the 


request/response unit (RU) as will fit. The data length field in the TH indicates the length of 
the RH and RU in bytes. 


LINE TRACE OUTPUT EXAMPLE (CS TYPE 2) 


COMMAND : F NET,TRACE,TYPE=LINE,ID=L140A0 


USRFD FF2 ASCB OOFDASCS& JOBN NET 
LINE L140A0 LRC(000,000) INBOUND ACTIVE RNTIME=69 
LCD 9 PCF 9 TIME 67 SCF 48 PDF 14 LCD 9 PCF 9 TIME 67 SCF 4D PDF 7E 
LCD 9 PCF 5 TIME 67 SCF 4D PDF 7E LCD 9 PCF 6 TIME 67 SCF OD PDF 7E 
LCD 9 PCF 7 TINE 67 SCF 49 PDF C6 LCD 9 PCF 7 TIME 67 SCF 49 PDF 71 
LCD 9 PCF 7 TINE 67 SCF 49 PDF 33 LCD 9 PCF 7 TIME 67 SCF 49 PDF F3 
LCD 9 PCF 6 TIME 67 SCF OD PDF F3 LCD 9 PCF 9 TIME 68 SCF 4D PDF 00 
LCD 9 PCF 9 TIME 69 SCF 4D PDF 7E LCD 9 PCF 9 TIME 69 SCF 48 PDF C6 
TIME 07217.244118 
USRxx nnn - identifies the formatting routine and nnn is the event ID that repres- 


ents the line trace. In this example the formatting routine 1s 
AMDUSRFD and the event ID is FF2. 


ASCB nnonnnnnn(MVS only)J- indicates the address of the ASCB for the address space that created 
the record (in this example OOFBA9C8). 


JOBN ccceccce - indicates the name of the job associated with the address space or par- 
tition (in this example NET). 


LINE nnnnnnnn - mnnnnnnn indicates the name of the node being traced (in this example 
line L140A0}. 


LRC(xxx, yyy) - indicates the number of records lost since the last trace record was 
written because of the inability of the trace facility to obtain an 
ACF/VTAM buffer. xxx is the destination'’s lost record count; and yyy 
is the source's lost record count. No records were lost in this exam- 
ple. 


INBOUND ~ indicates the direction of the data with respect to the host. Hence, it 
always says inbound because ACF/VTAM always receives the trace 
records from the NCP. 


LINE STATUS - has one of three values: ACTIVE, DEACTIVATE, or SLOKXDOKN. ACTIVE 
means that the line trace is active. DEACTIVATE means that the trace 
is not active because the NCP is in slowdown mode. A status of DEAC- 
TIVATE or SLONDOKN appears only in the last record sent for that 


GG24-1514-1 TOOLS/SERVICE AIDS PAGE 4-123 


GG24-1514-1 


RNTIME=hh 


ACF/SNA SYSTEM PROBLEM DETERMINATION GUIDE Vol. I 


line. It means that no more data will be sent until the trace is 
activated again for that line. 


is a timer field, where hh is a hexadecimal value indicating, in 

tenths of a second, the time at which the communications controller 
sent the completed line trace record to ACF/VTAM. This value is taken 
from a timer that is reset to 0 after 25.5 seconds. This value can 
be compared with the TIME value for the first level-two interruption 
data contained in the second part of the line trace record. This com- 
parison will show the elapsed time covered by this trace record. 
Comparing this with the number of level-two interruptions contained 
in the trace record indicates the I/O activity during the elapsed 
time. In this example, there were 6 level-two interrupts in 2 tenths 
of a second, which does not indicate any I/O activity problems during 
the creation of this record. 


The second part of the Line trace record contains a timer value and values from the interface 
control word CICH) and communications controller hardware registers at each level-two inter- 


ruption. 
interruptions. 


Each printed line will contain up to two sets of data, one for each of two level-two 
Refer to the NCP Handbook (LY30-3058) and the 3705 Communications Controller 


Principles of Operations (G6C30-3074) for detailed descriptions of these fields. 


LCD 


PFC 


TIME tt 


SCF 


PDF 


- the line control definer defines the type of protocol being used over the 


The LCD for a line is generally set when the NCP is loaded and 


remains unchanged throughout normal operation. 


~ the primary control field (PCF) defines the state of the line interface at 
any particular time. The exact meaning of the PCF depends on the value of 
the LCD. 


- this hexadecimal value indicates, in tenths of a second, the time elapsed 
between the activation of the line trace and the interruption represented 
by the data. The value of this timer is reset to 0 after 25.5 seconds. 


~- the secondary control field (SCF) is used as a sense, status, and operation 
modifier by the communication scanner and the control program. 


~ the parallel data field (PDF) is used as a character buffer. For a trans- 
mission, the characters to be sent are placed in the PDF by the program, 
transferred to the serial data field (SDF) by the hardware circuitry, and 
transmitted to the line interface. For a receive station, the character is 
assembled in the SDF and transferred by hardware to the PDF. 
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LINE TRACE OUTPUT EXAMPLE (CS TYPE 3) 


Reece EC DE SETS EE BP EEE ISI SPE ES SE A a PS TRL IIEARCSESE 


COMMAND : 


TIME 
USRFD FF2 ASCB OOFDA9C8 


LINE 


TIME 
USRFD FF2 ASCB OOFDASCS 
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LINE 


64865 .647953 


L14022 
STATUS 


STATUS 


STATUS 


STATUS 


STATUS 
STATUS 


STATUS 


STATUS 


STATUS 


64950 .695403 


L14022 


F NET, TRACE, TYPE=LINE,ID=L14022 


JOBN NET 
LRC( 000,000) 
SCF LCD PCF 
G7 9 9 
TEXT ABS9 
SCF LCD PCF 
43 9 6 
47 9 7 
TEXT CEC7 
SCF LCD PCF 
47 9 9 
TEXT AB99 
SCF LCD PCF 
43 9 6 
G7 9 7 
TEXT CEC7 
SCF LCD PCF 
47 9 4 
TEXT DBGA 
SCF LCD PCF 
47 9 9 
TEXT AB99 
SCF LCD PCF 
43 2. 6 
47 9 7 
TEXT CEC? 
SCF LCD PCF 
47 9 9 
TEXT AB9S 
SCF LCD PCF 
43 9 6 
JOBN NET 
LRC( 000,000) 


INBOUND 
EPCF 
00 


INBOUND 


STAT1L 


ACTIVE 
STAT2 
01 


STAT2 
00 


ACTIVE 
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RNTIME=37 
TIME ADDR 
02 D2 
TIME ADDR 
03 D2 
03 D2 
TIME ADDR 
04 D2 
TIME ADDR 
05 D2 
05 D2 
TIME ADOR 
05 c2 
TIME ADDR 
10 D2 
TIME ADDR 
11 p2 
11 D2 
TIME ADOR 
11 D2 
TIME ADDR 
11 D2 

RNTIME=37 


IOBLXB 
30 


¥wr 


¥.G 


30 


¥*.G 


IOBLXB 
30 


¥.r 


IOBLXB 
30 


DISP 
Ba 


ICW 
33 


CCBLV 
1cCDO 


CCBLV 
1IDBC 
LE2F 


CCBLV 
1cD0 


CCBLV 
IDBC 
LE2F 


CCBLV 
IcDO 


CCBLV 
1cD0 


CCBLV 
1DBC 
lE2F 


CCBLV 
1CD0 


CCBLV 
IDBC 
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USRxx nnn - identifies the formatting routine and nnn is the event ID that 
represents the line trace. In this example the formatting routine is 
AMDUSRFD and the event ID is FF2. 


ASCB nnnnnnnn (MVS only) - indicates the address of the ASCB for the address space that created 
the record (in this example OOFDA9CS&). 


JOBN ccceccce - Indicates the name of the job associated with the address space or 
partition (in this example NET). 


LINE nnonnnnnn - nmnnnnnn indicates the name of the node being traced (in this example 
line 114022). 


LRCCxxxs yyy ) - indicates the number of records lost since the last trace record was 
written because of the inability of the trace facility to obtain an 
ACF/VTAM buffer. xxx is the destination's lost record count, and yyy 
is the source's lost record count. No records were lost in this exam- 
ple. 


INBOUND - indicates the direction of the data with respect to the host. Hence, 
it always says inbound because ACF/VTAM always receives the trace 
records from the NCP. 


LINE STATUS - has one of three values: ACTIVE, DEACTIVATE, or SLOWDOKN. ACTIVE 
means that the line trace is active. DEACTIVATE means that the trace 
1s not active because the NCP is in slowdown mode. A status of DEAC- 
TIVATE or SLOKDOWN appears only in the last record sent for that 
line. It means that no more data will be sent until the trace is 
activated again for that line. 


RNTIME=hh -~ 3s a timer field, where hh is a hexadecimal value indicating, in 
tenths of a second, the time at which the communications controller 
sent the completed line trace record to ACF/VTAM. This value is taken 
from a timer that 1s reset to 0 after 25.5 seconds. This value can 
be compared with the TIME value for the first level-two interruption 
data contained in the second part of the line trace record. This com- 
parison will show the elapsed time covered by this trace record. 
Comparing this with the number of level-two interruptions contained 
in the trace record indicates the I/O activity during the elapsed 
time. In this example, there were 9 level-two interrupts in 53 
(H'35')} tenths of a second, which indicates an I/O activity problem 
during the creation of this record. 


The second part of the line trace record shows the operating parameters of a line each time an 
NCP buffer is filled, instead of each time a character is transmitted. The meanings of these 
additional fields in the type 3 scanner line trace record are explained in the 37x5 Communi- 
cation Controllers Principle of Operation and the NCP Handbook. 


SCF - the secondary control field (SCF) is used as a sense, status, and operation 
modifier by the communication scanner and the control pregram. 


LCD - the line control definer defines the type of protocol being used over the 
line. The LCD for a line is generally set when the NCP is loaded and 
remains unchanged throughout normal operation. 


PFC - the primary control field (PCF) defines the state of the line interface at 
any particular time. The exact meaning of the PCF depends on the value of 
the LCD. 

EPCF - the extended primary control field; these bits extend the meaning of the 
PCF. 

STATI ~ status byte 14 of the ICW. 

STAT2 ~ status byte 15 of the ICH. 

TINE nn - this hexadecimal value indicates, in tenths of a second, the time elapsed 


between the activation of the line trace and the interruption represented 
by the data. The value of this timer is reset to 0 after 25.5 seconds. 


ADDR ~ the SDLC address field. 

CNTL ~ the SDLC control field. 

IOBLXB ~ the l-byte command field from the IOB/LXB control block. 

DISP ~ byte 0 from the communication scanner display register. 

ICH - byte 13 of the interface control word. 

CCBLV - the address of the level-two interruption processor routine, taken from the 


NCP CCBLV control block. 


The text portion of the line trace record shows the contents of the NCP buffer being 
transmitted, in both hexadecimal and EBCDIC. 
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TRANSMISSION GROUP TRACE OUTPUT EXAMPLE 


e 
® 


COMMAND 


¥¥*¥ DATE DAY 264 


YEAR 1983 


USRFD FFe ASCB OOFDA7DO 


LINE 


‘Legoec 


F NET, TRACE, TYPE=TG, ID=L2402C 


JOBN NET 
LRC( 000,000) 
TEXT 

TEXT 

TEXT 

TEXT 


TEXT 


EXTERNAL TRACE - DD TRACE 


TIME 22.43.05.596214 


INBOUND 
40004742 2000002D 
00000014 QOACOBS0 
40001012 24/7F820C 
COADOO2D OO0FO390 
41001012 10004000 
00000000 0000 
40001012 200001A9 
OCO3600F6 002F0380 
40001012 2480020D 
COADOOF6 00038380 


ACTIVE 


RNTIME=B7 
0ooco00B 00000018 1C000001 
00010383 601687 

00000015 OOOCOOOE 10000036 
AO 

OOOOOOOE 00000015 10000000 


COOCOCOE 00000015 ICOO00AD 
40 
COOD0OIS OOODOODE 10000036 
00 
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USRxx nnn - identifies the formatting routine (e.g., AMDUSRFD). nnn is the event 
ID that represents the TG trace. 


ACSB nnonnnnnn (MVS only) - indicates the address of the ASCB for the address space that created 
the record. 


JOBN cececcce - indicates the name of the job associated with the address space or 
partition. 


LINE cccccece - indicates the name of the line "associated" with the TG trace. This 
line name was specified in the MODIFY TRACE command that started the 
TG trace. In this example, we ran the trace using line L2402C. 


LRCCxxx, yyy) - indicates the number of records lost since the last trace record was 
written due to the inability of the trace facility to obtain an 
ACF/VTAM buffer. xxx is the destination's lost record count, and yyy 


is the source's lost record count. No records were lost in this 
example. 


INBOUND ~- indicates the direction of the data with respect to the host. It 
always says INBOUND because the data is always received from the NCP. 


LINE STATUS - has one of three values: ACTIVE, DEACTIVATE, or SLONDOWN. ACTIVE 
means that the line trace is active. DEACTIVATE means that the trace 
is not active because the NCP is in slowdown mode. A status of DEAC- 
TIVATE or SLOKDOKN appears only in the last record sent for that 
line. It means that no more data will be sent until the trace is 
activated again for that line. 


RNTIME=hh - is a timer field, where hh is a hexadecimal value indicating, in 
tenths of a second, the time at which the communications controller 
sent the completed line trace record to ACF/VTAM. This value is taken 
from a timer that is reset to 0 after 25.5 seconds. This value can 
be compared with the TIME value for the first level-two interruption 
data contained in the second part of the line trace record. This com- 
parison will show the elapsed time covered by this trace record. 
Comparing this with the number of level-two interruptions contained 
in the trace record indicates the I/O activity during the elapsed 
time. 


TEXT - shows the TH and RH for each PIU that traversed the data path through 
the transmission group. If the PIU is for data flow control, session 
control, or network control, the full RU portion of the PIU is also 
included in the trace record. If the PIU is function management data 
(FMD), and contains an FM header, 6 bytes of the RU are included in 
the TG trace record. If an FMD PIU without an FM header is traced; 
the RU is not included. 
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4.4.2 3: VTAM INTERNAL TRACE 


DESCRIPTION 


The VTAM internal trace (VIT) differs from other 
ACF/VTAM service aids because it provides a record of 
events within ACF/VTAM, rather than information flow 
between ACF/VTAM and other network components. The VIT 
will show the sequence of internal events such as sche- 
duling of processes (POST, WAIT, DISPATCH, etc.}, stor- 
age management (GETSTOR, VTALLOC, etc.), and the flow 
of internal PIUs between ACF/VTAM components. 


Specifically, the internal trace can trace one or more 
of the following types of internal ACF/VTAM functions: 


® Application program interface (API) 
® Process scheduling services (PSS) 

@ Locking and unlocking (LOCK) 

® Storage management services (SMS) 

® Path information unit flow (PIU) 


® Messages (MSG) 


® SSCP request scheduling and response posting (SSCP) 
® Channel input/output (CIO) 


The internal trace output permits the reconstruction of 
sequences of ACF/VTAM events. In conjunction with the 
operator's console sheet and a dump, the internal trace 
can be used by the system programmer or a program sys- 
tams representative as a debugging tool to locate the 
cause of an ACF/VTAM failure. The internal trace can 
also be used to monitor ACF/VTAM control and resource 
flow. Certain performance conclusions can be drawn from 
analysis of internal trace output. 
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OPERATION 


To start the ACF/VTAM internal trace, use one of the 
following commands: 


e MODIFY procname, TRACE» TYPE=VTAM( , OPTION=options } 
® START procname, TRACE, TYPE=VTAM( ,OPTION=options } 


Use the START command to initiate the trace when 
ACF/VTAM is being started. Use the MODIFY command to 
initiate the trace when ACF/VTAM is already running. 


The operator can specify one or more of the following 
OPTION operands: API, LOCK, MSG, PIU, PSS, SMS», SSCP, 
CIO, or ALL. If OPTION=ALL is specified, all internal 
trace options will be in effect. 


The API, PIU, SSCP, and SMS trace records are written 
when an error condition is encountered and any internal 
trace option is active, whether or not the option for 
those records has been specified. 


In OS/VS systems, if the MODE=EXT option is specified, 
the records of the trace can be printed by GIF. In VSE 
systems, if the MODE=EXT option is specified, the 
records of the trace can be printed using the MODIFY 
TPRINT command or a separate batch job that uses the 
EXEC PGM=TPRINT statement. 


REFERENCE MANUALS 


For additional information, refer to the following man- 
uals: 


¢ ACF/VTAM Operation manual for information about 
starting/stopping the ACF/VTAM internal trace, and 
the various options (SC27-0612). 


®  ACF/VTAM Diagnosis Guide for internal trace record 
descriptions (SC27-0615). 


4.4.3 : LINK LEVEL 2 (LL2) TEST 


DESCRIPTION 


The Link level 2 SDLC line test tests an SDLC communi- 
cation line between an NCP (or ICA) and one of its 
peripheral physical units, or a link between two NCPs 
(ICAs). To test the link, ACF/VTAM sends test data over 
the link from the controlling NCP (ICA) to the remote 
station. The data is then echoed back to the sending 
NCP (ICA). This NCP (ICA) then compares the data 
received with the data sent and forwards the result to 
ACF/VTAM. ACF/VTAM sends a message to the console indi- 
cating how the link level 2 test ended. 


OPERATION 


The station being tested must be dedicated to the test. 
Therefore, it is not available to network users while 


it is being tested. Other stations on the same link, 
however, may continue to operate. 


The operator must first deactivate the link station or 
PU through the SSCP that owns the link, then issue the 
command 


MODIFY procname,LL2,ID=nodename,... 
The operator can specify: 


e Either a continuous link test or the number of test 
transmissions to be sent. 


® The cancellation of an ongoing link test. 


© Any user data to be included in the test trans- 
missions (otherwise ACF/VTAM supplies a default 
alphanumeric datastream). 


This command causes the SSCP to send in an Enter Test 
Mode RU to the NCP to which this terminal is connected. 
The NCP returns Test results to the requesting SSCP in 
a Record Test Data RU. When the test is completed, the 
operator receives the following: 


IST549I LL2 TEST FOR ID= P14022K ENDED SUCCESSFULLY 


IST24¢3I FRAMES SENT = 00100 RCVD 


which indicates: 


e the number of test frames transmitted by the host 
or communications controller. 


° the total number of test frames returned to the 
host or communications controller. 


° the number of test frames returned without error. 
The IBM 3274 and 3276 controllers will also record the 
results of the test and this data can be collected by 


the NPDA operator by using the following command: 
NPDA CTRL puname LINK 
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00100 RCVD WITHOUT ERRORS = 00100 


Refer to Example 5 in the NPDA section for more details 
about the LL2 test and its interaction with NPDA. 


REFERENCE MANUALS 


° ACF/VTAM Operation . . . . . SC27-0612 


ACF/VTAM Diagnosis Guide . . SC27-0615 (OS/VS) 
S$C27-0630 (VSE) 
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4.4.4 : OS/VS GTF 


DESCRIPTION 


The GTF is a facility of all the OS operating systems 
that allows the tracing and diagnosing of events. Other 
programs can also pass data to GTF for recording. The 
events that can be traced are system events such as I/0 
interrupts and all SVC interrupts and also user- 
defined events. 


However, we suggest the use of the program ACF/TAP to 
obtain all the listings of the GTF traces, as we have 
done in this guide. 


AVAILABILITY 


Both the trace and the print modules are included as 
part of the operating system. No special consider- 
ations are required during the SYSGEN. 


REFERENCE MANUALS 


® 0OS/VS1 SERVICE AIDS. oe © © © © #© © G6C28-0665 


® OS/VS2 SPL: SERVICE AIDS . .... . GC28-0674 


OPERATION 


The GTF procedure that is supplied by IBM in 
SYS1.PROCLIB does not have the 'TIME=YES' parameter. 
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For problem isolation in a teleprocessing environment, 
this parameter is generally necessary. Therefore, the 
procedure should be changed to add this feature. GTF 
should be started as a esystem task or in a 
partition/region that has high priority. This will put 
the least load on ACF/VTAM's buffers. If ACF/VTAM goes 
to a wait state during the running of line trace, 
ACF/VTAM either has insufficent IOBUFs or GTF's priori- 
ty is too low. 


The initiation of a trace and the starting of GTF are 
not dependent on each other. However, no trace data 
will be recorded unless both are running. 


ACF/VTAM uses two GTF trace options: 'RNIO' and 'USR'. 
If GIF is being used to trace the SIO's and Interrupts 
to a channel-connected device, such as a 370X or Local 
3274 or 3791, then the 'IOP’ and 'SIOP' options should 
also be specified. 


When using a DASD dataset to hold the trace data, GTF 
will ‘wraparound' when the end of extent(s) is reached. 
Tracing to a tape can eliminate this if it becomes a 
problem. | 


To initiate the GTF the START command must be used in 
accordance with the format 


S GTF,(parm) 


normally the parm is not keyed (The procedure should 
use TIME=YES). The trace options are also required. 
The options may be read from a member or entered when 
GTF prompts the operator after it is started. The min- 
imum option that is necessary is USR. 


The GTF is stopped with the command 


P GTF 
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4.4.5 3 ACF/TAP 


DESCRIPTION 


This is a service aid that provides formatting and sum- 
mary functions for ACF/VTAM trace datasets. It can 
simplify the analysis by providing a report that is 
easy to read and understand. 


To use the ACF/TAP: 
-Create the trace files 


~Start ACF/TAP, enterina the options 
~Interpret the output 


~>1SYS1. TRACE -——> | ACF /TAP sti 


Disk or Tape A Predefined options 
or prompting 


AVAILABILITY 


ACF/TAP is supplied as part of Release 6 of NCP as a 
System Support Program (SSP). 


REFERENCE MANUALS 


@ ACF/NCP UTILITIES . . 2. «© «© © © © © © SC30-3143 
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OPERATION 


The ACF/TAP processes the following traces: 


-ACF/NCP Line traces from CS 2 and 3. 
~ACF/VTAM RNIO traces 

-~ACF/VTAM Buffer traces 

-DOS/VSE IO traces 

-~TCAM PIU traces 


But not 


-ACF/VTAM Internal traces 
-ACF/VTAM Storage Management Services traces 


The trace dataset created by DOS/VSE ACF/VTAM or by 
OS/VS GTF (ACF/VTAM) is used as input to ACF/TAP. 
Based upon user specified options, ACF/TAP will print 
detail, summary or error reports. Trace records can be 
included in the analysis based upon record type, node 
name, or time-of-day. These options can be selected 
either by SYSIN statements or through the System Con- 
sole. Refer to ACF/TAP USER'S GUIDE for operational 
procedures. 


Since ACF/TAP allows many selection and formatting 
options, and the trace file may contain many records, 
it is often advisable to run with a ‘Summary' option 
first (such as the SNA SUMMARY ANALYSIS option). Based 
on what is shown at this level, the decision to runa 
Detail Report can be made. This procedure will require 
that the SYS1.TRACE or COMWRITE dataset in OS/VS or the 
TRFILE in DOS/VSE be retained until the problem can be 
identified. 


One very useful feature of analyzing line trace data is 
the ability to suppress the Receive Ready (RR) frames 
from the listing. This can reduce the size of the 
report significantly. There is also a feature for 
flagging when timeouts occur on a line. 


INTERPRETATION 


ACF/TAP assigns sequence numbers to trace records, mes~ 
sages, and line trace events. In order to relate dif- 
ferent reports to each other, it is critical that you 
understand the way in which ACF/TAP assigns these 


sequence numbers. Refer to Chapter 6 of the USER'S 
GUIDE for an explanation of the algorithm. 


The time-of-day of the trace record is available only 
on the SYSPRINT or SYSLST. If this is relevant to the 
problem analysis, this option must be selected in 


order to relate time-of-day to the ACF/TAP sequence 
numbers. 


SAMPLE OUTPUT 


For samples of the output produced by ACF/TAP refer to 


Chapter 6, SNA Device Flow. 
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4.4.6 : DYNADUMP 
DESCRIPTION 


The dynamic dump facility (DYNADUMP) is a service aid 
that transmits communication controller storage con- 
tents to the host over an emulator subchannel. This 
facility allows you to dump the NCP without stopping 
execution of the Network Controller Emulation Program. 


AVAILABILITY 


This service aid is only available 1f the NCP is gener- 
ated with a partition emulator program (PEP). You 
include this service aid by specifying the DYNADMP 
operand in the NCP BUILD macro. If only one channel 
adapter is installed on the 370X, an emulated 
sub-channel must be used for DYNADUMP, since NCP uses 
the native sub-channel address. 
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REFERENCE MANUALS 


IBM 3704 AND 3705 COMMUNICATIONS CONTROLLERS: 
NCP/VS GENERATION AND UTILITIES: GUIDE 
AND REFERENCE MANUAL. . . 2. 2 6 6 © 2 © © © GC30-3005 


OPERATION 


A batch job must be submitted to retrieve and format 
the storage dump. Refer to the NCP Generation and 
Utilities manual for a detailed explanation of how to 
use this facility. 


SAMPLE JCL 


DOS 


0S/VS 
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/7 JOB SEVP 
// KSSGN SYSLST,X'OOE‘ (output file) 
// ASSGN SYS010,X'280' (X'280° represents an unlabeled tape) 
// ASSGN SYSO011,X'001' (X'001' represents the controller address) 
//7 EXEC IFUSVEP 

DYNADMP STORAGE 

PRINT 

END 
/* 
7& 
//SVEP JOB MSGLEVEL=(1,1),... 
(7/7 EXEC PGM=IFLSVEP 
//7SYSPRINT DD SYSOUT=A 
//SYSUT1 DD UNIT=007 (communication controller address) 
//SYSUT2 DD. UNIT=TAPE , VOL=SER=SVTAPE; label=( ,BLP) ,DISP=OLD, 
1 DSN=WORK (optional temporary work dataset) 
//SYSIN- ODD % 

PRINT 

END 
7¥* 
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4.4.7 : ACF/NCP DUMP 


DESCRIPTION 


The NCP can be dumped through ACF/VTAM or by an inde- 
pendent dump utility supplied by NCP. 


AVAILABILITY 


The NCP dump utility program is supplied as a system 
service program on the SSPLIB file of the ACF/NCP dis- 
tribution tape. 


In order to dump the NCP aither through ACF/VTAM; or 
independently, the dump utility program must be copied 
from the NCP distribution tape to an authorized 0S/VS 
library or the CORE IMAGE LIBRARY for DOS/VSE. 


REFERENCE MANUALS 


IBM 3704 AND 3705 COMMUNICATIONS CONTROLLERS: 
NCP/VS GENERATION AND UTILITIES: GUIDE 
AND REFERENCE MANUAL. . . . 2... «© - 2 © - 6030-3008 
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OPERATION 
Khen ACF/VTAM is used to dump the NCP, the dump is ini- 
tiated at the console with the following commands: 


DOS/VSE - 
0S/VS = 


F NET,DUMP,ID=ncp-major-node-name 
F procname,DUMP, ID=ncp-ma jor-node-name 


ACF/VTAM dumps the communication controller's storage 
to the dataset specified in the BUMPDS operand of the 
PCCU macro. 


The dump can then be printed from this dataset using 
the appropriate dump print utility program, IFUDUMP for 
DOS/VSE or IFLDUMP for CS/VS. 


The communications controller storage can he dumped 
independently using the dump utility program, IFUREAD 
for DOS/VSE or IFLREAD for OS/VS. 


It is advisable to specify FORMAT=Y and BUF=Y. 


SAMPLE JCL 


DOS/VSE JCL to dump a 3705 and print the dump 


4/7 JOB DUMP DOS NCP 
/7 &SSGN SYS007,X'OBF' COBF is the controller address) 
7/7 DLBL NCPDUMP, 'NCP3DUMP',,DA 
// EXTENT SYS008;;5,,6880,12 
// ASSGN SYS008,SYSRES 
7/7 EXEC IFUREAD 
DUMP FORMAT=Y ,BUF=Y 
/* 


DOS/VSE JCL to print a 3705 dumped by VTAM 


77 JOB DUMPRT 
/7 MSSGN SYS008,X'131' (131 is unit containing storage dumped by VTAM) 
// DLBL = NCPDUMP, ‘NCP3DUMP', ,DA 
// EXTENT SYS008,111111 
/7 EXEC — IFUDUMP 
DUMP = FORMAT=Y,BUF=Y 
1*® 


OS/VS JCL to dump a 3705 and print the dump 


//CCDUMP JOB MSGLEVEL=(1,1)5... 
//EXEC EXEC PGM=IFLREAD 
//SYSPRINT DD SYSOUT=A 
//SYSUT1 DD UNIT=007 (communication controller subchannel used) 
//SYSUT2 DD UNIT=SYSDA,DISP=NEW, SPACE=(512,(513),,CONTIG); 
7/7 DCB=(DSORG=DA) (DASD work dataset) 
/7SNSIN DD * 
DUMP FORMAT=Y,BUF=Y 
7¥* 
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4.5 3 ACCESS METHOD DEFINITIONS 


4.5.1 : VTAMLST 


DESCRIPTION 


For OS/VS versions of ACF/VTAM, the network is defined 
ACF/VTAM by filing members representing each major node 
in SYSI.VTAMLST. On DOS/VSE systems, these statements 
are filed in the source statement library. 

ACF/VTAM currently has five types of major nodes. 

1. Application program major nodes 

2. Application cross-domain major nodes 

3. Local 3270 major nodes 

4. Local SNA major nodes 

5. Path major nodes 


6. NCP major nodes 


7. Terminal,LU cross-domain resources 
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8. CDRMs 


For DOS/VSE, the statements describing each major node 
included in the system are filed in VTAMLST/B.BOOK. 


Members describing | ACF/VTAM startup parameters 
(ATCSTRxx)} and network configurations (ATCCONxx) are 
also filed in VTAMLST or B.BOOK. By filing multiple 
members the account can specify different startup 


parameters and configuration to be used at ACF/VTAM 


startup time. 


REFERENCE MANUALS 


-ACF/VTAM PROGRAMMING . . . 2. © « © « « SC27-0449 


ACF/VTAM PIR . 2. 2 2 2 2 6 2 6 ee 6 - SC27-0584 


OPERATION 


When ACF/VTAM is started, the start parameters (LIST=) 
and the configuration (CONFIG=) to be used are speci- 
fied. Start parameters can also be overridden on the 
start command. If LIST= and CONFIG= operands are 
omitted on the start command, the default members 
ATCSTROO and ATCCONOO are used. 


4.6 3 HARDWARE TOOLS 


4.6.1 : 3704/3705 PANEL TEST 


DESCRIPTION 


The 3705 panel switches allow the operator to use the 
following functions: 

1. Dynamic display of an ICW 

2. Dynamic store (NCP 6 only) 

3. Network shutdown (if ANS=YES in NCP build macro) 


4. Address trace facility (if TRACE=YES in NCP build 
macro ) 


5. Activate/deactivate level 3 channel adapter trace 
(only ACF/NCP, NCP5 must be included in generation 
only when needed) 

6. Line test function (NCP5) 

a. Transmit test character 

db. Transmit test character and turn to receive 
c. Auto answer 

d. Dial operate 

e. Receive mode 


f. Transmit buffer 


g. Link Level Test 
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AVAILABILITY 


These control panel procedures are included in the NCP 
program in version 5 and later and in version 2 if 
PNLTEST=YES is specified on the build macro at gener- 
ation time. 


REFERENCE MANUALS 


GUIDE TO USING THE IBM 3704 COMMUNICATIONS 
CONTROLLER CONTROL PANEL GA27-3086 

GUIDE TO USING THE IBM 3705 COMMUNICATIONS 
CONTROLLER CONTROL PANEL GA27-3087 


OPERATION 


To use the panel test facility refer to the proper 
operator guide for step-by-step procedures. The con- 
trol panel procedures for NCP are in the above manuals. 


INTERPRETATION 


Refer to the 3705/3704 operator's guide for display 
panel output indicating the progress of test. 


SAMPLE OUTPUT 


Refer to Appendix I of the ACF/NCP/VS: INSTALLATION; 
for several sample programs. 
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4.6.2 3: 370X ON-LINE TESTS 


DESCRIPTION 


The 3704/3705 (370X) Communication Scanner On-line 
Tests (OLLTs) were designed to functionally test the 
hardware (line sets, line adapters, intergrated modems, 
and automatic call originate features) of the 370X com- 
munications controller, and SDLC links attached to the 
370X. The OLLTs reside in the host CPU and are called 
in using TOLTEP or TOTE and only affect the line being 
tested. The OLLTs may be divided into two categories: 


1. Those primarily designed for customer problem iden- 
tification. 


2. Those primarily designed for use by the CE. 


The tests in the first category were designed to be 
simple and to verify proper operation in the normal 
environment; i.@, use the same line control values as 
used by the NCP. The tests are T3700LTA through 
T3700LTF. Only one test falls into the second category, 
T3700LT. This section tests all the same functions as 
those in the first category, provides for an external 
data wrap, and also allows for the optional selection 


of the data to be wrapped. Chapter 12 describes the 
individual tests. 


AVAILABILITY 


Before any of the test sections can be run, the follon- 
ing program requirements must be met: 


1. TOLTEP or TOTE must be running in the system 
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2. A Network Control Program (NCP) that has the OLT 
option of the BUILD macro must be included in the 
3704/3705. 


3. The 3700 family of OLTs must be present in the OLT 
library. 


G. Each line's symbolic name entered in the test 
request message must be defined to VTAM and defined 
in the NCP. 


5. A line being tested may not be the same to which 
the control terminal is attached. 


6. Each line being tested must be varied off-line (in- 
active) prior to test initiation. 


REFERENCE MANUALS 


On-Line Terminal Test User's Guide. ..... . D99-3700C 
DOS/VSE and OS/VS TOLTEP for VTAM. ...... . GC28-0663 


This guide can only be obtained from an IBM Customer 
Engineer. 


OPERATION 


Information on the initiation and termination of test- 
ing and the options available may be found in the TOL- 
TEP SRL, "DOS/VSE and OS/VS TOLTEP for VTAM". 


4.6.3 : 3725 


DESCRIPTION 


The 3727 (3725's operator console) allows the operator 


to perform the following functions: 
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Address Compare (to force the CCU to perform a spe- 


cific action whenever a specified storage address 
is detected). 


Branch Trace (to save information about 
non-sequential instructions in the branch trace 
buffer). 


Display/Alter (to display CCU storage, local store 
registers, or work areas and to alter the CCU data 
being displayed). 


Display Long (to display CCU storage, local store 


registers, work registers, or CCU input registers 
in detail). 


System Control (to execute any of the following 
functions): 


- set the control program in instruction step 
mode. 


- request a CCU level 3 interrupt. 


_ let the CCU continue to run when a check condi- 
tion occurs. 


- force the CCU to hard-check when = an 
I0C-detected level 1 interrupt occurs. 


- generate a ‘reset tag' pulse on the IOC bus. 


- set the MOSS online to the control program and 
reset the data and time. 


- transfer to the CCU control program information 
necessary to select and execute NCP or EP func- 
tions and subroutines. 


The 
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Address Compare and Trace Parameter Display. 


Channel Adapter State and Register Display 


- to display the states of each channel adapter 


(enabled or disabled} as well as the current 
interface. 


- to display the registers of each channel adapt- 
er. 


Reset CCU/LSSD 


- to reset the entire CUU (LSSD, IOC, local store 
registers, 3725 storage 


- to reset only the LSSD 

Run a Wrap test 

- Cable level wrap 

—- Modem level wrap 

Line Interface Block Display (to display, at any 
time, and for ae specific line, the folloning 
fields; SDF ,SCF, SET MODE, CONTROL, MODEN-IN, MOD- 
EM-OUT, and the Hexadecimal Mask) 

Error Log Functions (once an error is detected, a 
Box Error Record (BER) is stored in the BER file to 
collect information on the error 

following are NCP functions: 

Line Test 

Dynamic Store 

Display of Storage 

Display of Registers 

Channel Discontact 


Address Trace 


Channel Adapter Trace 
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AVAILABILITY | | REFERENCE MANUAL 

These console functions are available to all 3725 IBM 3725 COMMUNICATION CONTROLLER OPERATING GUIDE 
users. GA33-0014 

PRODUCT DEPENDENCIES OPERATION 

ACF/NCP Version 2 To use the 3727 console facilities, refer to the opera- 


tor guide for step-by-step procedures. 


4.6.4 : PT-2 TP LINE MONITOR 


DESCRIPTION 


The PT-2 TP Line Monitor (TPLM) can display and record 
information appearing on a teleprocessing line. Line 
monitor capability is accomplished by an adapter, a 
PT-2, and a series of programs which execute itn the 
PT-2. The line monitor has the capability of monitoring 
transitions appearing on the EIA/CCITT interface or 
selected probe points within equipment containing inte- 
grated modems. Information can be recorded from 
start/stop, BSC; or SDLC lines. The user has the option 
to display only, record only, or display and record 
simultaneously at line speeds up to 9600 BPS. Prior to 
recording, the clock speeds are verified and the user 
specifies additional parameters to the program. During 
playback of the recorded data, the user can enter com- 
mands to the program to search for an event mark, 
optional probe change, record number, or a hex data 
pattern. 


AVAILABILITY 


The PT-2 is a tool that the Field Engineering Division 
has available for their use in problem determination. 


REFERENCE MANUALS 


The operator's manual for the PT-2, and the manual for 
the TP Line Monitor that comes with the tool. 


GG624-1514-1 


INTERPRETATION 


When data is displayed on the PT-2, the receive data is 
always underlined and control characters are always 
displayed in hex. The display program has many options 
that the user can select to format how the data will be 
displayed. The more common options are: 


¢ Data only in hex 
® Data only with text translation 
® Datatpads with control changes, data in hex 


® Datatpads with control changes, data with text 
translation 
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SAMPLE OUTPUT 


EXAMPLE OF BSC DATA ONLY 


5532324040 7F 7F 2DFF 
55323237FF 


EXAMPLE OF BSC DATA WITH TEXT TRANSLATION 


553232606040402DFF 
5532321070FF 


55323202 THIS IS TEXT TRANSLATION O36B3EFF 
5532321061 FF 
EXAMPLE OF BSC DATA+PADS AND CONTROL CHANGES 


FFFFRTIS+FFFFFFFFCTS+#FFFFFFFFFFFFFFEFFFRTS- CD+CTS-FFFFFF55323237FF 
FFFFRTS+FFFFFFFFCTS+55323240407F 7F2DFFRTS- CD+CTS-FFFFFFFFFFFFFFFF 


EXAMPLE OF DATA+PADS AND CONTROL CHANGES WITH TEXT TRANSLATION 


This would be the same format as above except that the hex characters between the start of text con- 
trol character and end of text control character would be translated from hex into English. 


4.6.5 3: LINE MONITORING AIDS 


DESCRIPTION 


There are several devices that can be used to help 
determine the status of a line. Indicators and tests in 
the dataset, indicators that can be displayed in the 
370X, and speakers that a telephone company can install 
that can be switched from Line to Line. 


DATASET INDICATORS 


Many of the datasets now in use have several indicators 
that are very useful in line problem determination. 
These indicators usually include dataset ready, request 


to send, clear to send, carrier detect, and data termi- 
nal ready. 


370X% INDICATORS 


Refer to page 4-141 of this manual for a description of 
the 3704/3705 panel tests. 


LINE SPEAKERS 
Some telephone companies have speakers and switches 


that can be installed on their lines so that you can 
switch a speaker onto a failing line. Listening to a 
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line when it is operating can enable you to determine 
if terminals are timing out, if one terminal has a low 
signal, if there is too much background noise, if an 
autodial line is operating properly, and if there is 
too much crosstalk on a line. 


IBM MODEM TESTS 


The tests refered to in this section apply to the IBM 
3872, 3874, 3875, and integrated modems. Tests A» B» C,» 
and D may be carried out for a centralized multipoint 
or point to point full-duplex configuration. In a mul- 
tipoint configuration, end-to-end testing is always 
done between the control modem and one of the tributary 
modems. Tests A», B, and E can be used to test switched 
network modems. 


Tests C through E require the cooperation of the 
other-end operator. The operators need to communicate 
to coordinate what test 1s to be performed, how long 
the test will run, and to watch the operate lights and 
signal meter. In each of the tests with the exception 
of test B, a fault is indicated by the operate lamp on 
the receiving modem going out. 


In the following block diagrams the asterisks show the 
flow of the test data and the X's show the normal path 
that is not being used (--X X-~). 
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BLOCK DIAGRAM SHOWING NORMAL OPERATION 


CPU EIA cable MODEM duplex telephone line MODEM EIA cable TERMINAL 


MODEM IN OPERATE MODEM IN OPERATE 


TEST A (T1) MODEM INTERNAL WRAP TEST 


| CPU EIA cable MODEM telephone line MODEM EIA cable TERMINAL 
x XK ex x 

DTE * DTE 
x ) nnnen aiekeiel X 


MODEM IN Tl MODEM IN Tl 


In test Tl the modem does not use the EIA interface and the line. The modem generates a test pat- 
tern, sends it through the transmitter, loops the pattern back to its own receiver, decodes the test 
data and checks it to determine if the modem circuits are working properly. The operate light will 
blink if the test fails. If the test fails, there is a problem with that modem. 
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TEST. B (T2) MODEM WRAP FROM THE TERMINAL 


CPU EIA cable MODEM telephone Line 


KKKKKKKKKKEK 


DTE 


KKK HK KHKHRKH mem eencenct remanence 9 


MODEM IN Te 


SX 


MODEM EIA cable TERMINAL 


RECEIVER | 3336263636 363€ 666 
DTE 
XMITTER =| HMI K 


MODEM IN Te2 


HRN 
% 
KR 


In test T2, the terminal generates the test pattern, sends it to the modem, the modem sends the data 
through the transmitter, loops it back to its onn receiver, demodulates the signal, and sends it 
back to the terminal which checks it to determine if the pattern has changed. (NOTE: not all termi- 
nals can use test T2.) If this test fails, there is a problem with either the modem or terminal. 


TEST C (T3 AND T3) MODEM END-TO-END TEST 


CPU EIA cable MODEM duplex telephone line MODEM EIA cable TERMINAL 
x JE BBE X 

DTE DTE 
x 3B BHR REO EE Xx 


MODEM IN T3 


MODEM IN T3 


The modem that is in test T3 generates the test pattern, sends it through its transmitter down the 
line to the other modem which demodulates the test pattern in its receiver and checks it to deter- 
mine if the pattern has changed. If both modems test good in Tl but not in T3, the problem 1s with 


the line. 
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TEST D (T3 AND T4) MODEM REMOTE WRAP TEST 


CPU EIA cable ODEM duplex telephone line MODEM EIA cable TERMINAL 


RECEIVER |***-X xX 
x 
XMITTER 


MODEM IN T3 MODEM IN T4¢ 


X xX XMITTER HHH HHH HHH HH HHH HEHE IIE IIE 
DTE | : 
X xX RECEIVER = | HHH HHH HH HHH HHH HHH HH KK HHH 


The modem that is in test T3 generates the test pattern, sends it through its transmitter down the 
line to the other modem which demodulates the test pattern in its receiver and checks it to deter- 
mine if the pattern has changed. It then loops it into the transmitter which modulates it and sends 
it back on the telephone line to the other modem which demodulates the test pattern in its receiver 
and checks it to determine if the test pattern has changed. The operate light will blink every time 
the pattern has changed. This test will only work if the telephone lines are full duplex. Failure in 
this test indicates a line problem. Not all terminals can use test T2. If this test fails, there 
is a problem with either the modem or terminal. 


TEST E (1T3/T¢)} MODEM END-TO-END TEST ON SWITCHED LINES 


CPU EIA cable MODEM switched telephone line MODEM EIA cable TERMINAL 


x 
DTE 


MODEM IN T3 MODEM IN T4 


For switched lines, the test can only be run in one direction at a time. Run the test one way then 
change the switch setting and run the test the other way. A failure indicates a line problem. 
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Setmode Moni tor Initiate Receive Disable 
for data Transmit Mode Mode 
set ready Mode 

V Vv V V V 


| a Modem 
—— > B<——Dependent 


Call incomplete|Call complete 


ee | |e | ee! 


Figure 11. EIA Interface Sequences: Start/Stop Mode on Switched Duplex Modem 
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Setmode Monitor Initiate Transmit 
for data- Transmit Mode 
set ready lode 
V V V V 


D.T.R _ | 


TRANSMIT DATA sccesinntusininamssticsnisminaadl cisllcd Uceupnieencapanintenmmpennsiensiainbainn 
TRANSMIT CLOCK , 
ince & 
scans DATA stmsninniuiiotnasiasmeaecentaiincnstemacminimminc Li Leswal Ul bmaed 


Figure 12. EIA Interface Sequences: Synchronous Mode on Switched Half-Duplex 
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